code-review-agent/START_PROJECT.md
Primakov Alexandr Alexandrovich 09cdd06307 init
2025-10-12 23:15:09 +03:00

3.1 KiB

🚀 Быстрый запуск проекта

Требования

  • Python 3.11+
  • Node.js 18+
  • Ollama установлен

Шаг 1: Ollama

Откройте терминал 1:

ollama serve

Оставьте терминал открытым.

Шаг 2: Backend

Откройте терминал 2:

cd backend

# Активируйте виртуальное окружение
source venv/Scripts/activate  # Git Bash/Linux/Mac
# ИЛИ
venv\Scripts\activate  # Windows CMD

# Запустите backend
python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Дождитесь сообщения:

INFO:     Uvicorn running on http://0.0.0.0:8000
INFO:     Application startup complete.

Шаг 3: Frontend

Откройте терминал 3:

cd frontend

# Запустите frontend
npm run dev

Дождитесь:

  ➜  Local:   http://localhost:5173/

🌐 Доступ

📝 Первое использование

  1. Откройте http://localhost:5173
  2. Перейдите в Репозитории
  3. Нажмите + Добавить репозиторий
  4. Заполните данные:
    • Название: my-project
    • Платформа: Gitea
    • URL: https://your-gitea.com/owner/repo
    • API токен: ваш токен из Gitea
  5. Нажмите Добавить
  6. Скопируйте Webhook URL из карточки
  7. Настройте webhook в Gitea (Settings → Webhooks → Add Webhook)

🔍 Ручная проверка

После добавления репозитория можете:

  1. Нажать кнопку 🔍 Проверить сейчас
  2. Система найдет все открытые PR и запустит ревью

⚠️ Важно

Если вы изменили ENCRYPTION_KEY в .env файле и получаете ошибку при расшифровке токенов:

  1. Удалите базу данных:

    cd backend
    rm review.db
    
  2. Перезапустите backend - база создастся автоматически

  3. Добавьте репозитории заново

🐛 Устранение проблем

Backend не запускается

cd backend
source venv/Scripts/activate
python -c "from app.main import app; print('OK')"

Если ошибка - проверьте .env файл.

Frontend не подключается

# Проверьте что backend запущен
curl http://localhost:8000/health

Ollama не отвечает

ollama list

Если пусто - установите модель:

ollama pull codellama:7b

📚 Документация