Skip to main content
This guide takes you from installation to chatting with Nagare.
1

Install Nagare

Make sure the $HOME/.local/bin directory is in your PATH, then check:
See details at Installation.
2

Start the gateway

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.
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

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.
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:
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:
See more at Troubleshooting.