--- title: "honcho" type: "tool" slug: "plastic-labs-honcho" canonical_url: "https://www.graphcanon.com/tools/plastic-labs-honcho" github_url: "https://github.com/plastic-labs/honcho" homepage_url: "https://docs.honcho.dev" stars: 5828 forks: 696 primary_language: "Python" license: "AGPL-3.0" categories: ["ai-agents"] tags: ["python", "long-term-memory", "context-engineering", "typescript", "ai-agents", "agent-memory"] updated_at: "2026-07-07T18:39:07.410188+00:00" --- # honcho > Memory library for building stateful agents Honcho provides memory infrastructure to build context-aware AI agents. It supports storing messages, events, and allows background reasoning for querying different representations from various models. ## Facts - Repository: https://github.com/plastic-labs/honcho - Homepage: https://docs.honcho.dev - Stars: 5,828 · Forks: 696 · Open issues: 148 · Watchers: 24 - Primary language: Python - License: AGPL-3.0 - Last pushed: 2026-07-07T15:25:01+00:00 ## Categories - [AI Agents](/categories/ai-agents.md) ## Tags python, long-term-memory, context-engineering, typescript, ai-agents, agent-memory ## Related tools - [ECC](/tools/affaan-m-ecc.md) - The agent harness performance optimization system (★ 226,962) - [hermes-agent](/tools/nousresearch-hermes-agent.md) - The self-improving AI agent built by Nous Research (★ 210,880) - [AutoGPT](/tools/significant-gravitas-autogpt.md) - AutoGPT: Build, Deploy, and Run AI Agents (★ 185,417) - [ollama](/tools/ollama-ollama.md) - Get up and running with Kimi-K2.6, GLM-5.1, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other models. (★ 175,659) - [langflow](/tools/langflow-ai-langflow.md) - Langflow is a powerful platform for building and deploying AI-powered agents and workflows. (★ 151,298) - [dify](/tools/langgenius-dify.md) - Production-ready platform for agentic workflow development (★ 148,070) - [firecrawl](/tools/firecrawl-firecrawl.md) - The API to search, scrape, and interact with the web at scale. (★ 147,117) - [langchain](/tools/langchain-ai-langchain.md) - The agent engineering platform. (★ 141,211) ## README (excerpt) ```text
Honcho
--- **Honcho is memory infrastructure for building stateful agents that understand changing people, agents, groups, projects, and ideas over time.** Store messages and events, let Honcho reason in the background, then query peer representations, session context, search results, or natural-language insights from any model or framework. Use it managed at [api.honcho.dev](https://api.honcho.dev) or self-host the FastAPI server yourself. Using Honcho as your memory system will earn your agents higher retention, more trust, and help you build data moats to out-compete incumbents. > Honcho has defined the Pareto Frontier of Agent Memory. Watch the [video](https://x.com/honchodotdev/status/2002090546521911703?s=20), check out our [evals page](https://honcho.dev/evals/), and read the [blog post](https://blog.plasticlabs.ai/research/Benchmarking-Honcho) for more detail. ## Contents - [Start Here](#start-here) - [Why Honcho](#why-honcho) - [The Honcho Loop](#the-honcho-loop) - [Quickstart](#quickstart) - [What Honcho Gives You](#what-honcho-gives-you) - [Integrations](#integrations) - [Core Concepts](#core-concepts) - [Benchmarks & Evals](#benchmarks--evals) - [Self-hosting](#self-hosting) - [Configuration](#configuration) - [Architecture](#architecture) - [SDKs](#sdks) - [Learn More](#learn-more) - [Contributing](#contributing) - [License](#license) The Honcho project is split between several repositories, with this one hosting the core service logic — implemented as a FastAPI server. Client SDKs for Python and TypeScript live in the [`sdks/`](./sdks) directory. ## Start Here | I want to... | Path | Get started | | -------------------------------------- | ---------------------------------------------------------- | ----------------------------- | | Give my coding agent persistent memory | Claude Code, OpenCode, OpenClaw, Hermes, or any MCP client | [Integrations](#integrations) | | Add memory to my product | Python or TypeScript SDK | [Quickstart](#quickstart) | | Self-host Honcho | Docker / local development | [Self-hosting](#self-hosting) | ## Why Honcho | Capability | What it means | | ----------------------- | ------------------------------------------------------------------------------------ | | Reasoning-first memory | Extracts conclusions from conversations and events, not just matching chunks. | | Peer-centric model | Tracks users, agents, groups, projects, and ideas as entities that change over time. | | Multi-peer perspective | Models what one peer knows about another when configured. | | Managed or self-hosted | Use `api.honcho.dev` or run the FastAPI server yourself. | | Agent-tool integrations | MCP, Claude Code, OpenCode, OpenClaw, Hermes, Cursor-compatible clients. | ## The Honcho Loop 1. **Store** conversations, events, documents, or tool traces as messages on a session. 2. **Reason** — Honcho processes the queue in the background and updates peer representations. 3. **Query** — ask Honcho for context, search results, peer representations, or a natural-language answer. 4. **Inject** — drop the result into any LLM call or agent framework. Concretely: workspaces hold peers, peers participate in sessions, messages live on sessions, and Honcho builds a per-peer representation that you query through the [Chat Endpoint](https://honcho.dev/docs/v3/documentation/features/chat) or directly. ## Quickstart Get an API key at [app.honcho.dev](https://app.honcho.dev) — when you sign up you'll be prompted ``` --- **Machine-readable endpoints** - JSON: [`/api/graphcanon/tools/plastic-labs-honcho`](/api/graphcanon/tools/plastic-labs-honcho) - LLM index: [/llms.txt](/llms.txt) - Full corpus: [/llms-full.txt](/llms-full.txt) _GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_