CrewAI в Docker на своём сервере
CrewAI в Docker это ваш Python-проект с командой агентов, упакованный в образ: готового образа у фреймворка нет, потому что CrewAI библиотека, а не сервер. На VPS команду агентов обычно запускают из HTTP-обработчика или фоновой очереди, а языковая модель отвечает по API.
Ответ за 30 секунд
Для одного проекта хватит 1 ядра и 2 ГБ памяти. Соберите образ на python:3.12-slim с uv, запускайте команду агентов в фоновом воркере, а не внутри HTTP-запроса, и передавайте ключи моделей переменными окружения, а не зашивайте их в образ.
OpenAI-совместимый API: адрес в OPENAI_BASE_URL, и агенты работают с GPT, Claude или DeepSeek без смены кода.
Сколько ресурсов нужно проекту на CrewAI3.10-3.13версии Python
MITлицензия
uvменеджер пакетов проекта
01 · 1 мин
Что такое CrewAI и что разворачивают на сервере#
CrewAI это открытый Python-фреймворк для многоагентных сценариев под лицензией MIT. В нём два уровня: Crews, где агенты с ролями сами договариваются о задаче, и Flows, где вы задаёте шаги, ветвления и состояние явно. Проект создаётся командой crewai create crew и запускается командой crewai run.
Управляемый деплой у разработчиков есть только в коммерческом наборе CrewAI AMP. Своя установка означает другое: вы сами упаковываете проект в контейнер и решаете, как задачи попадают к агентам. Если код писать не хочется, начните с визуальных инструментов на странице конструктор ИИ-агентов.
02 · 1 мин
Как устроен сервер с проектом на CrewAI#
| Часть | Что делает | Нужна ли |
|---|---|---|
| HTTP-сервис на FastAPI | Принимает задачу, отдаёт статус и результат | Если запуск идёт из сайта или CRM |
| Воркер | Вызывает crew.kickoff(inputs=...) и ждёт, пока агенты закончат | Да, если запуск дольше нескольких секунд |
| Redis | Очередь между API и воркерами | При нескольких запусках одновременно |
| PostgreSQL | История задач и результатов | По желанию |
Запуск команды агентов занимает минуты: каждый агент делает несколько обращений к модели. Если держать HTTP-запрос открытым всё это время, его оборвёт обратный прокси или клиент. Поэтому API возвращает номер задачи сразу, а результат забирают отдельным запросом.
03 · 1 мин
Dockerfile для проекта CrewAI#
- Создайте проект командой
crewai create crew. Если нужен Python-код с классом команды, добавьте флаг--classic: получится каркас сcrew.pyи YAML-настройками. - Зафиксируйте зависимости:
crewai installсоздаст окружение uv, файлuv.lockкладите в репозиторий. - Добавьте точку входа: файл
api.pyс FastAPI или скрипт воркера. - Соберите образ по Dockerfile ниже и запустите с
--env-file .env.
FROM python:3.12-slim
COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
WORKDIR /app
COPY . .
RUN uv sync --frozen --no-dev
CMD ["uv", "run", "uvicorn", "api:app", "--host", "0.0.0.0", "--port", "8000"]Порт 8000 публикуйте только на 127.0.0.1 и ставьте перед ним прокси с HTTPS. Python в образе должен попадать в диапазон фреймворка: от 3.10 до 3.13 включительно.
04 · 1 мин
Какие модели подключить к CrewAI на сервере#
По умолчанию агенты CrewAI обращаются к OpenAI API. Модель задаётся строкой вида провайдер/модель в переменной MODEL, а свой адрес OpenAI-совместимого API указывается в OPENAI_BASE_URL или параметром base_url. Так подключается AI Gateway с оплатой в рублях: код агентов менять не нужно.
Локальные модели идут через Ollama строкой вида ollama/llama3:70b. Помните про размер: модель на 70 млрд параметров требует сервер с видеокартой, на обычном VPS её ответов придётся ждать слишком долго.
Исполнение кода агентами
Инструмент CodeInterpreterTool убран из crewai-tools, а параметры исполнения кода у агента объявлены устаревшими. Документация советует отдельную песочницу, E2B или Modal, вместо запуска кода прямо на сервере.
Инструмент · 1 мин
Сколько ресурсов нужно проекту на CrewAI#
Пока модель отвечает по API, процесс CrewAI почти всё время ждёт ответа сети. Память добавляют под параллельные запуски, браузер или парсер сайтов в инструментах и под поиск по документам, если эмбеддинги считаются на сервере.
Какой сервер взять под проект на CrewAI
Сам фреймворк лёгкий, нагрузку дают параллельные запуски и инструменты
06 · 1 мин
Вопросы о CrewAI на сервере#
Есть ли официальный Docker-образ CrewAI?
Готового образа фреймворка для своих серверов нет: CrewAI ставится как Python-пакет в ваш проект. Образ собирают сами на основе python:3.12-slim, управляемый деплой есть в коммерческом CrewAI AMP.
Почему задача CrewAI обрывается по таймауту на сервере?
Скорее всего, команда агентов запускается прямо в HTTP-запросе и не успевает до таймаута прокси. Перенесите запуск в фоновый воркер и отдавайте клиенту номер задачи.
Какая версия Python нужна CrewAI?
От 3.10 и ниже 3.14. Зависимостями проекта управляет uv, его ставят официальным скриптом с astral.sh.
Почему этому можно верить
Как мы проверяли
Источники цифр на этой странице: AI Gateway Таймвеб Клауд, timeweb.cloud/services/ai-gateway, проверено 14 октября 2026; CrewAI: README и лицензия, github.com/crewAIInc/crewAI, проверено 14 октября 2026; Документация CrewAI: установка, docs.crewai.com/en/installation, проверено 14 октября 2026; Документация CrewAI: подключение моделей, docs.crewai.com/en/concepts/llms, проверено 14 октября 2026; Документация CrewAI: CodeInterpreterTool, docs.crewai.com/en/tools/ai-ml/codeinterpretertool, проверено 14 октября 2026.
Подключите модели через один API
OpenAI-совместимый шлюз: меняется только адрес и ключ, код остаётся прежним.
- Оплата рублями по факту расхода
- Модели GPT, Claude, Gemini, DeepSeek, Qwen
- Совместим с OpenAI SDK
- Без зарубежной карты