Быстрый старт

Минимальный gateway за пять минут: один агент, одна тулза, один крон. Дальше сразу Vault, потому что сетап Obsidian не менее важен, чем сервер, и уже за ним - мой beaver-agent как полный пример: оттуда можно взять архитектуру и узнать много нового.

Самый маленький сетап gateway

Сетап - это файл config.py, в котором определён объект gateway = Gateway(...). Загрузчик выполняет файл с уже привязанными ClaudeAgent, RaycastAgent, McpServer, ExposedMcp, Gateway.

В примере из репозитория gateway: один агент с промптом из временного файла, одна python-тулза current_time, один крон-джоб heartbeat, встроенные окна на порту 8000.

Запуск gateway

Единственный секрет, который нужен модели, - OAuth-токен подписки Claude. Он живёт год и тратит лимиты как обычный Claude Code.

cd examples
CLAUDE_CODE_OAUTH_TOKEN=$(claude setup-token) docker compose up --build

Compose рядом поднимает Postgres. Без Docker: uv sync, собрать SPA (cd ui && bun install && bun run build), uv run beaver-gateway с DATABASE_URL и CONFIG_PATH.

Что можно задать gateway

Gateway - один датакласс с типизированными полями. Всё, что дальше в доке, - это его поля:

Поле	Модуль
`agents`, `mcps`	промпты, скиллы, руки
`frontends`	окна
`jobs`, `budget`	джобы
`rotation`, `distiller`	разговоры
`watch`, `recall`, `user_sink`	память
`texts`, `tz`, `port`, `public_url`	тексты и деплой

Как растёт настоящий сетап beaver-agent

Когда конфиг перестаёт помещаться в страницу, он становится пакетом рядом. У меня config.py - 46 строк, всё остальное в beaver_agent/:

vault.py - пути и зона агента
prompts.py - как из гранул собирается промпт роли
skills.py - какое окно грузит какой набор
policy.py - что можно трогать в vault
hands/ - MCP и кому какая рука выдана
agents.py - роли и экземпляры
frontends.py - окна
texts.py - всё, что gateway говорит, по-русски
memory/ - справка, реплики, хендауты, вотчер, куратор
jobs/ - кроны и вебхуки

Дальше - модуль «Vault», и это не опционально: половина Менеджера - то, как разложен vault. Без него агенту нечего читать и некуда писать. А все модули после него - разбор этого пакета по способностям.