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…

  • AI
  • Tools & Utilities
Honcho is self-hosted memory infrastructure for AI agents that stores messages, derives context and peer conclusions in the background, and serves context queries, search, and historical recall over people, sessions, and ideas. honcho-aio packages the full stack—Honcho API, PostgreSQL 17 with pgvector, Redis, and s6 supervisor—into a single Unraid container, keeping all databases on loopback so nothing is exposed to your LAN. It provides a hosted memory backend for agent harnesses such as Hermes, letting you give agents persistent memory without running separate database containers.

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

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

Collected 26 days ago - public community threads