Перейти к основному содержанию
Self-hosted-развёртывание AgentFlow — шесть основных сервисов плюс зависимости. Они общаются через HTTP и общий Postgres. Эталонное развёртывание работает на Kubernetes (k3s); есть Docker Compose-вариант для одного узла.

​
Сервисы

agentflow-api

JSON API на Hono. Auth, маркетплейс, токены, проекты, FLOW-регистр, выплаты. Единый источник истины.

agentflow-agents

Рантайм агентов — форк Eliza с расширениями FLOW-сессии и FF-плагинов. Stateful, масштабируется горизонтально по тенантам.

agentflow-runtime

Лёгкий sandbox для tool-вызовов (браузер, код, файлы). Один pod на активную сессию; эфемерный.

claude-oauth-proxy

OAuth-прокси, посредничающий между рантаймом и Claude / Anthropic / OpenRouter API без утечки ключей.

agentflow-bot

Telegram-бот. Onboard’ит пользователей, шлёт уведомления, тригерит аппрувы. Общается с agentflow-api через /internal/*.

agentflow-postgres

Postgres 16 с pgvector. Хранит пользователей, агентов, токены, проекты, регистр, сессии.

​
Топология

                   ┌──────────────────────┐
   public traffic →│ ingress / nginx      │
                   └──────┬─────────┬─────┘
                          │         │
                          ▼         ▼
                   ┌────────────┐  ┌────────────┐
                   │ landing    │  │ web app    │
                   └────────────┘  └─────┬──────┘
                                         │
                                         ▼
                                   ┌─────────────┐
                                   │ api (Hono)  │
                                   └─┬───┬───┬───┘
              ┌──────────────────────┘   │   └──────────────────┐
              ▼                          ▼                      ▼
       ┌────────────┐             ┌────────────┐         ┌────────────┐
       │  agents    │             │  postgres  │         │   bot      │
       └────┬───────┘             └────────────┘         └────────────┘
            │
            ▼
     ┌─────────────────┐
     │ runtime sandbox │
     └─────────────────┘
            │
            ▼
   ┌─────────────────────┐
   │ claude-oauth-proxy  │ → Anthropic / OpenRouter
   └─────────────────────┘

​
Data plane

ХранилищеКто использует
PostgresВсё persistent-состояние. Схема в agentflow-api/src/db/schema.ts.
Object storage (S3-совместимое)Скриншоты агентов, сгенерированные изображения, артефакты проектов.
Redis (опциональный)Счётчики rate-лимитов, эфемерный SSE replay buffer. Откатывается на Postgres, если отсутствует.

​
Tenancy

Эталонное развёртывание — single-tenant. Multi-tenant вариант с vCluster на каждого пользователя описан отдельно (Phase 2 roadmap; не включено по умолчанию). В локальной разработке vCluster включать не следует.

​
С чего начать

Манифесты Kubernetes

Применяйте поставляемые k8s/-манифесты в каждом репозитории сервиса.

Переменные окружения

Полный справочник env, сгруппированный по сервисам.
Self-host AgentFlow в продакшне требует аккаунтов у платёжных провайдеров (CryptoBot, Platega, USDT BEP20) и LLM-провайдера (Anthropic, OpenRouter). Сама платформа открыта, но рельсы — нет.