Self-hosted AI agents with persistent memory.
Talk to an AI that remembers your previous conversations, learns your preferences, and builds a knowledge graph over time. Give it a name, a personality, and goals. Run it from a terminal dashboard, HTTP API, or Signal messenger.
One binary. No containers. No external databases. No cloud dependencies beyond your LLM provider.
Quickstart · Configuration · Deployment · Architecture
See QUICKSTART.md for install instructions, setup, and first run.
- Persistent memory. Conversations carry forward. The agent builds a knowledge graph of facts, entities, and relationships that persists across sessions and grows over time.
- Multiple agents. Each agent has its own character (SOUL.md), goals, memory, and workspace. They can coordinate, delegate, and specialize.
- Tools. 33 built-in tools: file I/O, shell execution, web search, memory search, agent coordination. Extend with domain packs or custom tools.
- Terminal dashboard. Rich TUI with markdown rendering, session management, and real-time streaming.
- Signal messaging. Talk to your agents over Signal with 15 built-in commands.
- Privacy. No telemetry, no analytics, no phone-home. Only outbound connections are to services you configure.
Rust workspace with 18 crates. Single binary deployment. See ARCHITECTURE.md for the full dependency graph and trait boundaries.
Every name follows a deliberate naming philosophy. Greek provides precision where English flattens: nous over "agent" because these are minds, not tools. Mneme over "store" because memory is the function, not the container. See gnomon.md for the naming system and lexicon.md for the full registry.
Each agent has a workspace under nous/ with character, operations, and memory files. See instance.example/nous/_template/ for a template, WORKSPACE_FILES.md for the full reference.
- TUI - Terminal dashboard. Rich markdown rendering, session management.
- Signal - 15
!commands.!helpfor the list. - CLI -
aletheia helpfor the full command reference. - API - REST on port 18789. See ARCHITECTURE.md.
| Service | Port | Required |
|---|---|---|
| aletheia | 18789 | Yes |
| signal-cli | 8080 | For Signal |
No telemetry. No phone-home. No analytics, crash reports, or beacon requests.
The only outbound connections are to services you explicitly configure (LLM provider, Signal). Everything else stays on your machine. See DATA.md for the data inventory, NETWORK.md for every network call the binary makes.
AGPL-3.0-or-later for the runtime and all crates. Apache-2.0 for SDK and client libraries (when published). See LICENSE.