> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nagare.smtdfc.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Install Nagare, start the gateway, add a model provider, and send your first message.

This guide takes you from installation to chatting with Nagare.

**1. Install Nagare**

> [tab] Linux / macOS
>
> ```bash theme={null}
> curl -fsSL https://raw.githubusercontent.com/smtdfc/nagare/main/installers/linux/install.sh | sudo bash
> ```

> [tab] Windows (PowerShell)
>
> ```powershell theme={null}
> irm https://raw.githubusercontent.com/smtdfc/nagare/main/installers/window/install.ps1 | iex
> ```

Make sure the `$HOME/.local/bin` directory is in your `PATH`, then check:

```bash theme={null}
nagare --version
```

See details at [Installation](https://docs.nagare.smtdfc.net/en/installation.md).

**2. Start the gateway**

```bash theme={null}
nagare gateway start
```

The gateway runs in the foreground of the current terminal window and listens at `localhost:9832`. Keep this window open and use another terminal for the next steps.

> [!NOTE]
>
> On the first run, Nagare automatically generates a 4096-bit RSA key pair and saves it to the operating system's keyring. This key is used to sign and verify login tokens.

**3. Open the web interface**

```bash theme={null}
nagare web
```

This command automatically creates a login token and opens the browser at `http://127.0.0.1:3005`. You are logged in automatically.

**4. Add a model provider**

Go to **Settings → Model providers** and add an **OpenAI** or **Google** compatible provider, enter your API key, and select a model. See [Model Providers](https://docs.nagare.smtdfc.net/en/guides/model-providers.md).

**5. Select the default model**

Go to **Settings → General**, select **Default model** (the provider and model used for new conversations).

**6. Start chatting**

Create a new conversation and try:

```text theme={null}
What time is it? List the 5 processes using the most RAM.
```

Nagare will automatically find and call the appropriate tools. For risky operations (deleting files, shutting down...), you will be asked to approve beforehand.

## System Check

If you encounter errors, run:

```bash theme={null}
nagare doctor
```

See more at [Troubleshooting](https://docs.nagare.smtdfc.net/en/troubleshooting.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.