{"id":47669448,"url":"https://github.com/forkwright/aletheia","last_synced_at":"2026-05-28T06:12:03.731Z","repository":{"id":339046792,"uuid":"1150919060","full_name":"forkwright/aletheia","owner":"forkwright","description":"Distributed cognition system — infrastructure, tooling, and continuity","archived":false,"fork":false,"pushed_at":"2026-04-13T21:18:37.000Z","size":246664,"stargazers_count":1,"open_issues_count":15,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-13T22:34:40.824Z","etag":null,"topics":["ai-agents","exocortex","multi-agent","privacy-first","rust","self-hosted","tui"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/forkwright.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-05T21:02:36.000Z","updated_at":"2026-04-13T21:18:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/forkwright/aletheia","commit_stats":null,"previous_names":["forkwright/aletheia"],"tags_count":68,"template":false,"template_full_name":null,"purl":"pkg:github/forkwright/aletheia","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forkwright%2Faletheia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forkwright%2Faletheia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forkwright%2Faletheia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forkwright%2Faletheia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/forkwright","download_url":"https://codeload.github.com/forkwright/aletheia/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forkwright%2Faletheia/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31842193,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T11:29:19.690Z","status":"ssl_error","status_checked_at":"2026-04-15T11:29:19.171Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","exocortex","multi-agent","privacy-first","rust","self-hosted","tui"],"created_at":"2026-04-02T12:26:48.541Z","updated_at":"2026-05-28T06:12:03.724Z","avatar_url":"https://github.com/forkwright.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aletheia\n\nSelf-hosted AI agents with persistent memory.\n\nTalk 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.\n\nOne binary. No containers. No external databases. Beyond your LLM provider, there are no cloud dependencies.\n\n[Quickstart](docs/QUICKSTART.md) · [Configuration](docs/CONFIGURATION.md) · [Deployment](docs/DEPLOYMENT.md) · [Architecture](docs/ARCHITECTURE.md)\n\n---\n\n## Install\n\nDownload the tarball from [releases](https://github.com/forkwright/aletheia/releases), extract, and run `init`:\n\n```bash\nVERSION=v0.27.0\ncurl -L \"https://github.com/forkwright/aletheia/releases/download/${VERSION}/aletheia-linux-x86_64-${VERSION}.tar.gz\" \\\n  -o aletheia.tar.gz\ntar xzf aletheia.tar.gz\ncd \"aletheia-${VERSION}\"\nsudo cp aletheia /usr/local/bin/\naletheia init\n```\n\nThe tarball contains `instance.example/` with the reference config layout. See [QUICKSTART.md](docs/QUICKSTART.md) for full install, macOS, and source build instructions.\n\n---\n\n## What you get\n\n- **Persistent memory.** Conversations carry forward. The agent builds a knowledge graph of facts, entities, and relationships that persists across sessions and grows over time.\n- **Working-memory continuity.** Each turn can inject agent-curated `\u003ckey_info\u003e` from the prior working checkpoint before recall and history are assembled.\n- **Multiple agents.** Each agent has its own character (SOUL.md), goals, memory, and workspace. They can coordinate, delegate, and specialize.\n- **Tools.** 49 built-in tools: file I/O, shell execution, web search, memory search, planning, agent coordination, plus external MCP tools bridged through the organon tool plane.\n- **Runtime guardrails.** Tool calls carry HMAC-SHA256 receipts, loop detection combines ping-pong, no-progress, and doom-loop signals, and per-stage timeouts bound long-running turns.\n- **Terminal dashboard.** Rich TUI with markdown rendering, session management, and real-time streaming.\n- **Signal messaging.** Talk to your agents over Signal with 15 built-in commands.\n- **Privacy.** No telemetry, no analytics, no phone-home. Only outbound connections are to services you configure.\n\n---\n\n## Architecture\n\n44 Rust workspace crates plus the excluded desktop shell. Single binary deployment. The substrate includes persistent sessions, Datalog-backed memory, working-memory injection, HTTP/SSE, MCP, Signal, dispatch, and a 15-scenario substrate canary suite. See [ARCHITECTURE.md](docs/ARCHITECTURE.md) for the full dependency graph and trait boundaries.\n\n---\n\n## Naming\n\nEvery 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 kanon's `~/dev/kanon/crates/basanos/standards/GNOMON.md` for the naming system and [lexicon.md](docs/lexicon.md) for the full registry.\n\n---\n\n## Agents\n\nEach agent has a workspace under `nous/` with character, operations, and memory files. See `instance.example/nous/_template/` for a template, [WORKSPACE_FILES.md](docs/WORKSPACE_FILES.md) for the full reference.\n\n## Interfaces\n\n- **TUI** - Terminal dashboard. Rich markdown rendering, session management.\n- **Signal** - 15 `!` commands. `!help` for the list.\n- **CLI** - `aletheia help` for the full command reference.\n- **API** - REST on port 18789. See [ARCHITECTURE.md](docs/ARCHITECTURE.md).\n\n## Services\n\n| Service | Port | Required |\n|---------|------|----------|\n| aletheia | 18789 | Yes |\n| signal-cli | 8080 | For Signal |\n\n## Privacy\n\nNo telemetry, phone-home, analytics, crash reports, or beacon requests.\n\nThe only outbound connections are to services you explicitly configure (LLM provider, Signal). Everything else stays on your machine. See [DATA.md](docs/DATA.md) for the data inventory, [NETWORK.md](docs/NETWORK.md) for every network call the binary makes.\n\n## License\n\nAGPL-3.0-or-later for the runtime and all crates. Apache-2.0 for SDK and client libraries (when published). See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforkwright%2Faletheia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fforkwright%2Faletheia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforkwright%2Faletheia/lists"}