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

# Introducing Nagare

> Nagare is an AI assistant that runs locally on your computer, helping automate work, system tasks, and reminders.

**Nagare** (流れ, meaning "flow") is an AI assistant that runs locally on your desktop (Linux, macOS, and Windows). Nagare runs in the background, connects to the language model of your choice, and uses tools to interact directly with the system: managing processes, reading/writing files, adjusting volume, taking screenshots, setting up scheduled tasks, and much more.

Your data (chat history, configuration, API keys) is stored on your machine, in the `~/.nagare` directory.

## Key Features

> [card] [Chat with AI](https://docs.nagare.smtdfc.net/en/guides/web-ui.md)
>
> Web interface and desktop application for chatting, managing sessions, and configuration.

> [card] [System Tools](https://docs.nagare.smtdfc.net/en/guides/tools.md)
>
> Over 20 built-in tools, with an approval mechanism before running dangerous operations.

> [card] [Scheduled Tasks (cron job)](https://docs.nagare.smtdfc.net/en/guides/cronjobs.md)
>
> Ask Nagare to automatically do a task on a schedule, for example every morning at 9 AM.

> [card] [Telegram Channel](https://docs.nagare.smtdfc.net/en/guides/telegram.md)
>
> Chat and approve tools right within Telegram.

> [card] [Multiple Model Providers](https://docs.nagare.smtdfc.net/en/guides/model-providers.md)
>
> Use any OpenAI-compatible or Google API.

> [card] [Extend with Plugins](https://docs.nagare.smtdfc.net/en/plugins/overview.md)
>
> Write plugins in Go or Rust, package and digitally sign them for distribution.

## Architecture

Nagare consists of the following components:

| Component | Description |
| - | - |
| `nagare` | CLI used to start the gateway, open the web interface, create tokens, build plugins, and check the system. |
| `nagare-gateway` | The main background process. Provides REST API and WebSocket (default port `9832`), runs the agent, tools, cron jobs, and manages plugins. |
| Web interface | Embedded React application, served by the `nagare web` command (default `http://127.0.0.1:3005`). |
| `nagare-desktop` | Desktop application (Wails) sharing the same interface as the web version. |
| Plugin | Independent processes, communicating with the gateway via IPC (Unix socket or Windows named pipe). |
| `nagare_vector` module | Rust module serving semantic memory. |

The gateway is written in Go, the memory module and Rust plugin SDK are written in Rust, and the interface is written in React 19.

## Next Steps

> [card] [Quickstart](https://docs.nagare.smtdfc.net/en/quickstart.md)
>
> Install and send your first message in a few minutes.

> [card] [CLI Reference](https://docs.nagare.smtdfc.net/en/reference/cli.md)
>
> All commands and flags of `nagare`.


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