Self-hosting
Requirements & architecture
Flipper self-hosts as one image run three ways. Everything else is managed infrastructure you already know how to operate.
The three processes
ProcessCommandResponsibility
apinpm run start:apiHTTP API, MCP transport, OAuth, webhooks.
workersnpm run workersIngest, synthesis, embedding, crons. Without it nothing is learned.
webnpm run start:webThe Next app and its BFF proxy.
Dependencies
PostgreSQL 15+ with the
pgvectorextension.Redis for queues, rate limits and quota counters.
S3-compatible object storage for episodes.
An LLM provider key for synthesis.