selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

1flowbase logo

Self-host 1flowbase

v0.5.8

AI Gateway and app runtime you host yourself for agents

BetaOpen SourceApache-2.0
Updated9 hours ago
LanguageRust
Setup difficultyAdvanced
Stars
284
Port
3100 (Web console)
Requires
PostgreSQL
Docker
ghcr.io/taichuy/1flowbase-web
Install with Docker Compose
Workflow orchestration console showing model routingPublic API publishing with OpenAPI 3.1 documentStatistics dashboard with token totals and cost by modelPages and AI assistant editing console pagesMCP management console with instances and tool settingsVisual workflow editorAPI publishing interfaceDetailed execution logsToken usage dashboard

What is 1flowbase?

An AI Gateway and application runtime you host yourself, built for agents. One entry point serves many model providers — OpenAI, Anthropic, Gemini, DeepSeek, and any OpenAI-compatible API — handling conversion among three major AI protocols. All gateway conversations persist in PostgreSQL, creating a reusable dataset for cost tracking, model evaluation, and business logic. Build visual workflows that merge models and tools into virtual models, define dynamic business tables with auto-generated CRUD APIs and OpenAPI 3.1 specs, and craft custom React interfaces using native code blocks. Every capability is API-first and reachable by agents through an MCP Gateway with progressive tool discovery (list, get, call). Deploy via Docker images on ghcr.io with internal or external PostgreSQL. Licensed Apache-2.0.

Should you self-host 1flowbase?

1flowbase scores 47/100 on selfhost.directory (how scoring works) and ranks #23 of 39 in API Gateway. It has 284 GitHub stars.

It shipped 21 stable releases in the past year. The latest, v0.5.8, came out on 22 October 2026. New versions land roughly every 2 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Rust.

Its closest alternative on selfhost.directory is OmniRoute (88/100, 82 028 stars). It scores higher overall, so compare the two before you pick. See 1flowbase vs OmniRoute side by side.

Features

  • Agent-Native Design
  • AI Gateway
  • API-First Backend
  • Conversation Data Retention
  • File storage
  • MCP Gateway
  • Model-as-Tool Delegation
  • Multi-protocol support
  • Observability & Audit
  • Plugin System
  • React Blocks
  • Usage analytics
  • Workflow Engine
  • Workspaces

1flowbase README

How to install 1flowbase

Install 1flowbase with Docker Compose

Docker with Docker Compose

cd docker && docker compose pull && docker compose up -d --remove-orphans

Internal PostgreSQL mode; external-db variant uses docker-compose.external-db.yaml

How to configure 1flowbase

  • API_COOKIE_SECUREfalseUse secure session cookies

    Use secure session cookies

    values: true, false

  • API_OFFICIAL_PLUGIN_GITHUB_PROXY_URLGitHub proxy URL for plugin downloads

    GitHub proxy URL for plugin downloads

  • API_OFFICIAL_PLUGIN_SIGNATURE_REQUIREDtrueRequire official plugin signatures

    Require official plugin signatures

    values: true, false

  • API_PROVIDER_SECRET_MASTER_KEYMaster key for encrypting provider secrets

    Master key for encrypting provider secrets

  • BOOTSTRAP_ROOT_ACCOUNTrootInitial root account username

    Initial root account username

  • BOOTSTRAP_ROOT_PASSWORD1flowbaseInitial root account password

    Initial root account password

  • DATABASE_MODEinternalDatabase mode (internal or external PostgreSQL)

    Database mode (internal or external PostgreSQL)

    values: internal, external

  • EXTERNAL_POSTGRES_DB1flowbaseExternal PostgreSQL database name

    External PostgreSQL database name

  • EXTERNAL_POSTGRES_HOSTExternal PostgreSQL host/IP

    External PostgreSQL host/IP

  • EXTERNAL_POSTGRES_PASSWORDExternal PostgreSQL password

    External PostgreSQL password

  • EXTERNAL_POSTGRES_PORT5432External PostgreSQL port

    External PostgreSQL port

  • EXTERNAL_POSTGRES_SSLMODEpreferExternal PostgreSQL SSL mode

    External PostgreSQL SSL mode

    values: disable, allow, prefer, require, verify-ca, verify-full

  • EXTERNAL_POSTGRES_USERpostgresExternal PostgreSQL user

    External PostgreSQL user

  • FLOWBASE_API_SERVER_VERSIONlatestAPI server image version tag

    API server image version tag

  • FLOWBASE_WEB_VERSIONlatestWeb image version tag

    Web image version tag

  • POSTGRES_PASSWORDInternal PostgreSQL password

    Internal PostgreSQL password

  • WEB_PORT3100Web console port

    Web console port

1flowbase releases & version history

FAQ

Is it free to use?

1flowbase is open source under Apache License 2.0. You provide the hosting, database and model-provider access; those may have their own costs.

Are application templates available?

Gateway applications can already be configured from Agent templates, and the extension center has a place for application templates. Ready-made business application templates are still in progress.

Can an agent build a complete application?

The runtime is API-first and its capabilities are exposed through MCP, and the console includes a built-in AI assistant. The official tools and agent experience are still being improved.

Where is my data stored?

PostgreSQL is the current primary data source. Gateway conversations are retained there, alongside your business data.

Which AI protocols are supported?

1flowbase converts between Anthropic Messages, OpenAI Chat Completions and OpenAI Responses. Each application publishes /v1/messages, /v1/chat/completions, /v1/responses and /v1/models, plus a native agent API with WebSocket, cancel and resume.

What is 1flowbase?

1flowbase is an open-source, self-hostable AI Gateway and AI application runtime that connects model access, workflows, conversation data, APIs, business data, MCP and React interfaces.

More in AI Workflows

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…