Установка

DocAI можно запустить двумя способами: через Docker (рекомендуется) или локально.

Docker (рекомендуется)

Требования

• Docker 20.10+
• Docker Compose 2.0+
• 4GB RAM минимум

Установка

# Клонировать репозиторий
git clone <repository-url>
cd docai

# Настроить окружение
cp .env.backend.template .env.backend
cp .env.frontend.template .env.frontend

# Запустить
docker compose up -d

Сервисы Docker Compose

Сервис	Порт	Описание
db	5432	PostgreSQL база данных
redis	6379	Redis для Celery
api	8000	Django API
web	3000	Next.js frontend
celery-worker	-	Celery воркер
celery-beat	-	Celery scheduler
docusaurus	3002	Документация

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

Backend

Требования:

• Python 3.13+
• uv (пакетный менеджер)
• PostgreSQL 14+
• Redis

cd backend

# Установка зависимостей
uv sync

# Применение миграций
uv run -- python manage.py migrate

# Создание суперпользователя
uv run -- python manage.py createsuperuser

# Запуск сервера
uv run -- python manage.py runserver 0.0.0.0:8000

В отдельных терминалах запустите Celery:

# Worker
uv run celery -A api worker --loglevel=info --concurrency=1

# Beat (scheduler)
uv run celery -A api beat --loglevel=info

Frontend

Требования:

• Node.js 21+
• pnpm

cd frontend

# Установка зависимостей
pnpm install -r

# Запуск dev сервера
pnpm --filter web dev

Проверка установки

Проверка API

curl http://localhost:8000/api/schema/swagger-ui/

Проверка Frontend

Откройте http://localhost:3000 в браузере.

Проверка Celery

docker compose exec api uv run celery -A api inspect active

Проблемы при установке

Port already in use

# Найти процесс
lsof -i :8000

# Остановить
kill -9 <PID>

Database connection refused

Убедитесь, что PostgreSQL запущен и доступен:

docker compose logs db

Redis connection error

docker compose logs redis