A clean, zero-config management UI for self-hosted Honcho API servers.
Honcho is an open-source memory library for building stateful AI agents. Honcho-Panel gives you a visual interface to manage workspaces, peers, sessions, messages, and more — without touching the API directly.
- Workspace management — create, browse, search, and delete workspaces
- Peer explorer — view peer representations, cards, and session history
- Session viewer — browse session timelines and message threads
- Conclusion search — semantic search across derived insights
- Peer chat — query a peer's memory using natural language
- Zero configuration — works out of the box with same-origin reverse proxy setups
- Runtime API URL — configure the Honcho API address from the browser; no rebuild needed
- Pure static SPA — no server runtime, deploy anywhere
git clone <repo-url> honcho-panel
cd honcho-panel
docker compose up -dOpen http://localhost:8080 → enter your Honcho API URL → done.
To rebuild after pulling updates: docker compose up -d --build.
npm install
npm run build # produces dist/
npx serve dist -l 8080 # or any HTTP servernpm install
npm run dev # Vite dev server with HMR at localhost:5173See docs/DEPLOYMENT.md for environment configuration and deployment options.
- Open the Panel in your browser
- Select or create a workspace from the dropdown in the sidebar
- Configure API URL in Settings if needed (e.g.
http://localhost:8110) - Browse overview, peers, sessions, conclusions, and chat with peers
The API URL is saved in your browser and persists across sessions. Change it anytime from the sidebar.
If you serve Honcho-Panel and the Honcho API on the same domain (e.g. nginx proxies / to Panel and /api to Honcho), no setup page appears — the Panel auto-detects the API URL. Just open and go.
React 19 · TypeScript · Vite 6 · TanStack Query · shadcn/ui · Tailwind CSS v4 · Honcho SDK
See docs/DEVELOPMENT.md for development setup, docs/ARCHITECTURE.md for architecture and tech stack, docs/DEPLOYMENT.md for deployment.
MIT © Kecheng Zhang