Skip to main content

​
Requirements

  • Operating system: Linux, macOS, or Windows.
  • CPU architecture: amd64 or arm64.
  • An API key from an OpenAI-compatible or Google model provider.
  • The operating system’s keyring must be functional (Nagare stores the RSA key there).

​
Install via Script

The installation script will:
  1. Download the latest release nagare-<OS>-<ARCH>.tar.gz from GitHub Releases. If the current directory contains ./dist/nagare, the script installs directly from the dist directory instead of downloading.
  2. Install three executables into $HOME/.local/bin:
    • nagare: CLI.
    • nagare-gateway: gateway process.
    • nagare-desktop: desktop application.
  3. Copy assets to ~/.nagare/assets/ (built-in plugins, core plugins, and web interface).
  4. Install the nagare_vector module into ~/.nagare/modules.

​
Add to PATH

If the nagare command is not found, add $HOME/.local/bin to your PATH:
Replace ~/.bashrc with ~/.zshrc if you use zsh.

​
Verify Installation

nagare doctor will report a gateway error when the gateway is not running. This is normal before you run nagare gateway start.

​
Desktop App

nagare-desktop opens the “Nagare Desktop” window using the same interface as the web version. The application reads two environment variables to log in automatically:
If you do not set these variables, you can paste the token directly on the login screen.

​
Data Directory

All data is located in ~/.nagare. See Configuration for details. To completely uninstall, stop the gateway, delete the executables in $HOME/.local/bin, and delete the ~/.nagare directory.