Honcho-AIO
Honcho is self-hosted memory infrastructure for AI agents that stores messages, derives context and peer conclusions in the background, and serves context…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
49/100 Fair
- Maintained
- 86last commit 15 days ago
- Popular
- 00 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 26 days ago
- GitHub stars
- 0
- Open issues
- 3
- Last commit
- 2026-11-06
- Latest release
- v3.3.0-aio.2
- Activity
- declining
Checked 8 days ago - source: GitHub (wgross19/honcho-aio)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Run the local setup wizard Install honcho-cli with `uv tool install honcho-cli`, then run `honcho start --setup basic`. It asks for an LLM provider and key, then starts Docker, which is needed to run the local Honcho services. source
- Tell the CLI to use the local stack After the local stack is running, prefix CLI commands with `HONCHO_BASE_URL=http://127.0.0.1:8000` and run `honcho doctor`. Without that, the CLI may keep talking to the old or wrong server instead of your local one. source
- Keep your local stack files safe Your local stack settings live in `~/.honcho/profiles/local/`, so back that folder up if you want to keep the same profile after reinstalling. Losing it can mean re-entering your setup and provider configuration. source
- First-run setup 1. Set PostgreSQL Password (required; container exits with code 64 if empty). 2. Set EMBEDDING_MODEL and CHAT_MODEL as provider/model (split on the first slash; nested model slashes are preserved, e.g. openrouter/openai/gpt-5.4-mini). 3. If using local/, set LOCAL_BASE_URL (local chat has no cloud fallback). 4. Fill only the API key for the provider you chose. 5. Start the container, then point He source
Fetched 40 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Why does honcho-aio exit with code 64 on first boot?
It refuses to start if POSTGRES_PASSWORD is empty. Set a PostgreSQL password before the first boot.
Are the Postgres and Redis services reachable from the LAN?
No. PostgreSQL and Redis are loopback-only and are never published. Agents connect only through the Honcho HTTP API on port 8000.
How do I configure the embedding and chat models for local or cloud use?
Set EMBEDDING_MODEL and CHAT_MODEL as provider/model strings, splitting on the first slash. For local/, set LOCAL_BASE_URL to the OpenAI-compatible endpoint, and local chat has no cloud fallback. Boot fails if the embedding width does not match EMBEDDING_VECTOR_DIMENSIONS; the default is 768 for embeddinggemma.
How are Honcho versions managed in honcho-aio?
The container is pinned to official plastic-labs/honcho tags. It uses HONCHO_VERSION and HONCHO_GIT_SHA to select the pinned build.
Answers sourced from github.com
Community
- Reddit (reddit)
- Question :: Honcho General Discussions - Steam Community (other)
- Honcho General Discussions :: Steam Community (other)
- Honcho - Reddit (reddit)
Collected 26 days ago - public community threads