The self-improving AI agent originally built by Nous Research as Hermes Agent. This is a local-first, terminal-first fork — stripped of Electron GUI, web UI, and Nous provider baggage. Gaia keeps what works: the CLI, gateway, skills, and the parts that make daily use better.
Use any model you want — OpenRouter (200+ models), NovitaAI, NVIDIA NIM, Xiaomi MiMo, z.ai/GLM, Kimi/Moonshot, MiniMax, Hugging Face, OpenAI, Anthropic, or your own endpoint. Switch with gaia model — no code changes, no lock-in.
| A real terminal interface | Full TUI with multiline editing, slash-command autocomplete, conversation history, interrupt-and-redirect, and streaming tool output. |
| Lives where you do | Telegram, Discord, Slack, WhatsApp, Signal, and CLI — all from a single gateway process. Voice memo transcription, cross-platform conversation continuity. |
| A closed learning loop | Agent-curated memory with periodic nudges. Autonomous skill creation after complex tasks. Skills self-improve during use. FTS5 session search with LLM summarization for cross-session recall. |
| Scheduled automations | Built-in cron scheduler with delivery to any platform. Daily reports, nightly backups, weekly audits — all in natural language, running unattended. |
| Delegates and parallelizes | Spawn isolated subagents for parallel workstreams. Write Python scripts that call tools via RPC, collapsing multi-step pipelines into zero-context-cost turns. |
| Runs anywhere | Six terminal backends — local, Docker, SSH, Singularity, Modal, and Daytona. Run it on a $5 VPS or a GPU cluster. |
| Research-ready | Batch trajectory generation, trajectory compression for training the next generation of tool-calling models. |
# Install
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
# Start chatting
source ~/.bashrc
gaia
# Choose your model
gaia model
# Configure tools
gaia tools
# Start the gateway
gaia gateway setup
gaia gateway startgaia # Interactive CLI — start a conversation
gaia model # Choose your LLM provider and model
gaia tools # Configure which tools are enabled
gaia config set # Set individual config values
gaia gateway # Start the messaging gateway
gaia setup # Run the full setup wizard
gaia update # Update to the latest version
gaia doctor # Diagnose any issuesThis fork intentionally removes:
- Electron GUI / Desktop app — terminal-first, no web layer
- Docusaurus website — docs are upstream, not bundled
- Nous provider / auth — not used locally; stubs provided for import compatibility
- Non-English locales — English only
See plan.md and gaia-agent.md in the vault for the full fork philosophy.
This is a personal fork. Contributions are welcome but the scope is intentionally narrow — local-first, terminal-first, no bloat.
git clone https://github.com/ilyaizen/gaia-agent.git
cd gaia-agent
uv pip install -e ".[all,dev]"MIT — see LICENSE.
Originally built by Nous Research. Forked and maintained by ilyaizen.