← all repositories
plastic-labs/honcho

Your agents need a hippocampus, not a filing cabinet

Honcho treats memory as structured reasoning over time, not just vector search with extra steps.

6.1k stars Python AgentsRAG · Search
honcho
Velocity · 7d
+22
★ / day
Trend
accelerating
star history

What it does Honcho is a memory server for AI agents that stores conversations and events, then reasons about them in the background to build dynamic representations of users, agents, groups, and projects. You query these representations — or raw context, search results, or natural-language insights — through Python/TypeScript SDKs or a managed API. It self-hosts as a FastAPI server or runs managed at api.honcho.dev.

The interesting bit The “peer” model is the twist: humans and AI agents are first-class entities on equal footing, and Honcho tracks what one peer knows about another, not just a flat history of prompts. Background reasoning is asynchronous — write messages, let Honcho chew on them, query conclusions later. There’s a tension here between freshness and depth that the README openly flags.

Key highlights

  • Reasoning-first, not retrieval-first: extracts conclusions from conversations rather than just matching chunks
  • Peer-centric ontology: workspaces → peers (users and agents) → sessions → messages; multi-peer sessions with configurable observation rules
  • Dual deployment: managed cloud with $100 free credits, or fully self-hosted FastAPI server
  • MCP-native integrations: Claude Code, OpenCode, OpenClaw, Hermes, Cursor-compatible clients; also raw SDK for custom products
  • Hybrid search: BM25 + vector across peers, sessions, or global scope
  • Prompt-ready exports: session.context(...).to_openai(...) / .to_anthropic(...) with token budgeting

Caveats

  • Background reasoning is async by design — newly added messages won’t immediately reflect in chat/representation responses; low-latency paths exist but trade off depth
  • The “Pareto Frontier of Agent Memory” claim is marketing language; the linked evals and blog post are referenced but not reproduced in the README
  • Core service logic lives here; client SDKs are in a subdirectory, suggesting multi-repo complexity

Verdict Worth a look if you’re building multi-agent systems or long-running personal assistants where user modeling matters more than stateless RAG. Skip it if you just need cheap vector search for a single-turn chatbot — that’s overkill and you’ll fight the async model.

Frequently asked

What is plastic-labs/honcho?
Honcho treats memory as structured reasoning over time, not just vector search with extra steps.
Is honcho open source?
Yes — plastic-labs/honcho is open source, released under the AGPL-3.0 license.
What language is honcho written in?
plastic-labs/honcho is primarily written in Python.
How popular is honcho?
plastic-labs/honcho has 6.1k stars on GitHub and is currently accelerating.
Where can I find honcho?
plastic-labs/honcho is on GitHub at https://github.com/plastic-labs/honcho.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.