honcho
Memory library for building stateful agents
What is honcho?
Memory library for building stateful agents
Overview of honcho
What it is
Honcho is a memory library for building stateful agents. It stores messages and events, processes them in the background to build representations of peers (users, agents, groups, projects, ideas), and provides query endpoints for context, search, or natural-language insights. It can be used as a managed service at api.honcho.dev, run locally with honcho start, or self-hosted via the FastAPI server. The project is licensed under AGPL-3.0 and is open source. The core service is a FastAPI server; client SDKs for Python and TypeScript are included in the repository. A CLI tool (honcho-cli) is also provided.
Key features
- 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,
honcho startlocally, or run the FastAPI server yourself. - Agent-tool integrations: MCP, Claude Code, Cursor, Grok Bot, OpenCode, Kilo Code, OpenClaw, Hermes.
Use cases
Honcho is designed for developers building stateful agents that need persistent memory. Use cases include giving coding agents (such as Claude Code, Cursor, Grok Bot) shared memory across sessions, adding memory to products via Python or TypeScript SDKs, running Honcho locally for development or testing, and inspecting a deployment with CLI commands. The library is intended to help agents achieve higher retention and trust by maintaining context about users, agents, groups, projects, and ideas over time.
Getting started
Get an API key at app.honcho.dev, or install the CLI and run honcho start --setup for a local stack. Then point the SDK at the appropriate URL. Python and TypeScript quickstart examples are provided in the repository README. Below are the install commands:bashpip install honcho-ai# or: uv add honcho-ai# or: poetry add honcho-ai``````bashnpm install @honcho-ai/sdk# or: bun add @honcho-ai/sdk
License and pricing
The license is AGPL-3.0. The project is open source. Pricing is not stated in the provided metadata or README.
Based on the project's public README and repository metadata.