Версия

Локальная установка

Установите и запустите стек одним скриптом установки или склонируйте репозиторий и запустите вручную.

1. Быстрая установка через install.sh

Установщик скачивает tagged-релиз, собирает образ локально и запускает стек; образ/профиль выбирает установщик. Повторный запуск обновляет на месте. Явная версия: VERSION=0.1.0 sh install.sh.

curl -fsSL https://raw.githubusercontent.com/Arttron/aigentron/main/install.sh | sh

Или клонируйте исходники (опционально)

git clone https://github.com/Arttron/aigentron.git
cd aigentron

Требования

  • Docker Desktop или Docker Engine + Compose v2 (обязательно)
  • Опционально: Ollama, запущенная на хосте (не в контейнере), для routine-модели — лишь один из вариантов провайдера, а не обязательное требование. Оркестратор обращается к ней через http://host.docker.internal:11434
  • ANTHROPIC_API_KEY — для complex-модели (облачный Claude)
  • Опционально: модель с поддержкой инструментов в вашем Ollama на хосте (по умолчанию qwen3-coder:30b, задаётся через ROUTINE_MODEL в .env) — только если вы выбрали Ollama
  • Опционально: одноразовая Docker-сеть, чтобы агенты находили БД проектов по имени сервиса (docker network create lds-agents) — только для compose-сценария с агентами
  • Если вы всё же используете Ollama, избегайте qwen2.5-coder — он не поддерживает структурированные вызовы инструментов и ломает SDK агентов. Поддерживаемый стандарт — qwen3-coder:30b.

2. Опционально: локальные модели через Ollama

Только если вы выбрали Ollama в качестве провайдера. Загрузите в Ollama на хосте (не в контейнер); укажите ROUTINE_MODEL в .env, если выбрали другую модель.

ollama pull qwen3-coder:30b

3. Опционально: внешняя Docker-сеть

Одноразовая настройка, нужна только для compose-сценария с агентами — чтобы агенты находили БД по имени сервиса.

docker network create lds-agents

4. Из исходников: сборка и запуск

Для сборки из исходников: эквивалент docker compose up -d --build. Поднимает Postgres, Redis, LiteLLM (Anthropic-совместимый прокси перед Ollama), оркестратор (:3001) и dashboard (:3000), всё с bind-mount для горячей перезагрузки. Первый запуск медленнее — оркестратор компилирует packages/shared и packages/agent-runner до прохождения healthcheck.

make up

5. Откройте dashboard

Dashboard → http://localhost:3000 • API оркестратора → http://localhost:3001 Показаны значения по умолчанию; в некоторых конфигурациях порт dashboard может отличаться — переопределите его через маппинг портов (compose или docker run -p). Опционально: docker compose --profile mcp up -d для Playwright MCP и dev-сервера для frontend/design-агентов.

Полезные команды: make logs | make ps | make migrate | make down | make clean (⚠️ удаляет данные БД). Более подробная документация по настройке, маршрутизации моделей и approval gate — в репозитории.

На главную