heropen
Persistent memory for local AI agents. One
pip install, never start from scratch again.
Every new session, your agent forgets — project structure, tool preferences, past pitfalls, custom skills. heropen fixes that: after install, your agent remembers everything.
100% local. SQLite + vector search. No cloud, no telemetry.
Install
pip install heropen
Restart your agent. That's it.
On first start, heropen auto-detects your agent (Claude Code, Cursor, Windsurf, or any MCP client), configures the database, and registers memory tools. You agent will notice the new install and offer to guide you through setup.
Quick Start
# Save a memory
heropen add "Project uses FastAPI + SQLAlchemy, tests with pytest"
# Search your memories
heropen search "project tech stack"
# Check status
heropen status
# Diagnose issues (v1.8+)
heropen diagnose
Connect Your Agent (MCP)
Works with any agent that supports MCP. Auto-setup (v1.8+) detects and configures automatically — no manual config needed.
Or add this to your agent config manually:
{
"mcpServers": {
"heropen": {
"command": "heropen",
"args": ["mcp"]
}
}
}
Restart your agent, and it has memory. Your agent will auto-save and search memories on the fly — hit a bug once, remember it forever across sessions.
What's New in v1.8
- Zero-setup install — auto-setup runs automatically on first interpreter start
- Agent self-guidance — tool descriptions now tell your agent when to use each tool, not just what it does
- Welcome workflow — new installs detected via health check, agent proactively offers to complete setup
heropen diagnose— one-command troubleshooting for MCP config, DB, agent detection, and version checks- Auto-setup logging — every step logged to
~/.heropen/setup.log; success/failure shown in terminal - stdout fix — MCP protocol no longer corrupted by heartbeat messages (reported by community)
Why heropen
| heropen (free) | Others | |
|---|---|---|
| Memory storage | Unlimited | Often capped |
| Search | Unlimited | Per-query billing |
| Internet required | No | Yes |
| Your data stays | Your machine | Their servers |
| Setup | pip install one line |
Server + config |
Free = full core. No gating.
Support
- Homepage: ksmn.cc/heropen
- Docs: ksmn.cc/heropen/docs
- Issues: GitHub Issues
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file heropen-1.8.4.tar.gz.
File metadata
- Download URL: heropen-1.8.4.tar.gz
- Upload date:
- Size: 201.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a42c792c188ecc65f107f30afdcf8d06ed843f794f4d9710cd0247a3893d4ed1
|
|
| MD5 |
a7fda7749a36be211c9cab7588b7d3b2
|
|
| BLAKE2b-256 |
8400af3956924901cef5a71c5154beec77908c34c45540c39d1c9b0750859b4f
|
File details
Details for the file heropen-1.8.4-py3-none-any.whl.
File metadata
- Download URL: heropen-1.8.4-py3-none-any.whl
- Upload date:
- Size: 73.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e396365db5db288ce5f6bec8824c235ef6dda5c26344c71c5c9ffb2f968487b8
|
|
| MD5 |
d14047003fac014fb8ddc12fda1a1950
|
|
| BLAKE2b-256 |
203e4f116e6bbd3ca6c87f101db1014c32d1e1cc13f6fcf532f357e4929f1071
|
