Skip to main content

Honcho

Cross-session memory for Hermes. Without it, every agent conversation starts cold; with it, what the agent learned about you last week is still there this week.

Containers

ContainerRole
honchoFastAPI memory server (port 8000)
honcho-postgresPostgreSQL + pgvector for vector storage

Access

Internal only — http://honcho:8000 on the exist network. There is no Caddy hostname for it by default; add a reverse_proxy block if you want the API docs at https://honcho.EXIST_DOMAIN/docs.

Enable

EXIST_IS_AI_HONCHO=true

Then ./existential.sh && docker compose up -d from the repo root.

Activation

Honcho needs to be registered with Hermes once, after both containers are healthy:

docker exec -it hermes-agent hermes memory setup honcho

Notes

Its Postgres volume is volumes/honcho_postgres_data, declared db: true — pgvector on an embedded database, so local only and never NFS.