Interactive Shell

$ python -m minisgl --model "Qwen/Qwen3-0.6B" --shell

$ Hello! Can you help me understand what recursion is?

Recursion is a programming technique where a function calls itself to solve a problem. Think of it like looking in a mirror that reflects another mirror - each reflection contains a smaller version of the same image.

In programming, recursive functions have two key parts:
1. Base case - where the function stops calling itself
2. Recursive case - where the function calls itself with a simpler version of the problem

For example, calculating factorial:
- factorial(5) = 5 × factorial(4)
- factorial(4) = 4 × factorial(3)
- ... and so on until factorial(1) = 1 (base case)

$ Thanks! Can you show me a simple example in Python?

Sure! Here's a simple recursive function to calculate factorial:

```python
def factorial(n):
    # Base case
    if n == 0 or n == 1:
        return 1
    # Recursive case
    return n * factorial(n - 1)

print(factorial(5))  # Output: 120

## Shell Commands

The shell supports special commands prefixed with `/`:

### /reset

Clears the conversation history and starts a new session:

<Note>
This command removes all previous messages from the context, allowing you to start fresh without restarting the process.
</Note>

### /exit

Exits the shell and terminates the process:

Alternatively, press `Ctrl+D` (EOF) to exit.

## Configuration

The shell mode uses environment variables for default generation parameters:

<ParamField path="SHELL_MAX_TOKENS" type="integer" default="2048">
  Maximum tokens to generate per response
</ParamField>

<ParamField path="SHELL_TEMPERATURE" type="float" default="0.7">
  Sampling temperature for responses
</ParamField>

<ParamField path="SHELL_TOP_K" type="integer" default="50">
  Top-k sampling parameter
</ParamField>

<ParamField path="SHELL_TOP_P" type="float" default="0.9">
  Nucleus sampling parameter
</ParamField>

Set these before launching:

```bash
export SHELL_MAX_TOKENS=512
export SHELL_TEMPERATURE=0.9
python -m minisgl --model "Qwen/Qwen3-0.6B" --shell

$ What is Python?
[Model explains Python...]

$ What are its main use cases?
[Model answers based on context about Python...]