alange/honcho

Python

7 environment variables found in .env.template

Set these on your host before deploying. Each platform has an “Environment Variables” section in the deploy flow.

LOG_LEVEL Application Settings
PERFORMANCE_LOG_FORMAT
DB_CONNECTION_URI Database Settings (REQUIRED) Connection URI for PostgreSQL database with pgvector support Must use postgresql+psycopg prefix for SQLAlchemy…
AUTH_USE_AUTH Authentication Settings Whether to enable authentication (set to true for production)
LLM_OPENAI_API_KEY secret LLM Provider (REQUIRED) Honcho uses LLMs for memory extraction, summarization, dialectic chat, and dream consolidation. The server will…
VECTOR_STORE_TYPE Vector Store Settings Vector store type: "pgvector", "turbopuffer", or "lancedb"
VECTOR_STORE_MIGRATED Migration flag: set to true when migration from pgvector is complete

Best match Fly.io Anything Dockerized — requires the Fly CLI.

macOS

brew install flyctl && fly launch --from https://github.com/alange/honcho

Linux

curl -L https://fly.io/install.sh | sh && fly launch --from https://github.com/alange/honcho

Windows (PowerShell)

iwr https://fly.io/install.ps1 -useb | iex; fly launch --from https://github.com/alange/honcho

Or deploy to a different host