Dorod-Sky/QUICK-START.md

Skyvern Quick Start

Быстрый запуск Skyvern с прокси для обхода geo-restriction OpenAI API.

Prerequisites ✅

• ✅ Python 3.11+
• ✅ PostgreSQL 16 (порт 5433)
• ✅ Redis 7 (порт 6380)
• ✅ Playwright Chromium установлен
• ✅ HTTP прокси с доступом к OpenAI API

1. Запуск сервисов

# PostgreSQL
docker start postgres-dorod  # или ваш контейнер

# Redis
docker start redis-dorod  # или ваш контейнер

# Проверка
pg_isready -h localhost -p 5433
redis-cli -p 6380 ping

2. Запуск Backend

cd /home/vodorod/dorod/skyvern

# Убить старые процессы
pkill -9 -f "uvicorn skyvern.forge.api_app:app"

# Запустить backend
.venv/bin/python -m uvicorn skyvern.forge.api_app:app --host 0.0.0.0 --port 8000

# Или в фоне с логами
nohup .venv/bin/python -m uvicorn skyvern.forge.api_app:app --host 0.0.0.0 --port 8000 > backend.log 2>&1 &

# Проверить
curl -s http://localhost:8000/api/health | python3 -m json.tool

3. Создать API токен (если нужен новый)

cd /home/vodorod/dorod/skyvern
.venv/bin/python scripts/create_api_key.py org_development

Текущий токен (действителен до 2126):

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjQ5MTY1NzMxNjAsInN1YiI6Im9yZ19kZXZlbG9wbWVudCJ9.SXWQ9WGmJ-UN7sqCBd3oVhdXfi2rsbFatusjyMvczpM

4. Тестовая задача

curl -X POST http://localhost:8000/api/v1/tasks \
  -H "Content-Type: application/json" \
  -H "x-api-key: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjQ5MTY1NzMxNjAsInN1YiI6Im9yZ19kZXZlbG9wbWVudCJ9.SXWQ9WGmJ-UN7sqCBd3oVhdXfi2rsbFatusjyMvczpM" \
  -d '{
    "url": "https://www.python.org",
    "navigation_goal": "Extract the main heading",
    "data_extraction_goal": "Extract main heading text",
    "proxy_location": "NONE"
  }'

Ожидаемый результат:

{"task_id": "tsk_..."}

5. Проверить результат

# Замените TASK_ID на полученный task_id
curl http://localhost:8000/api/v1/tasks/TASK_ID \
  -H "x-api-key: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjQ5MTY1NzMxNjAsInN1YiI6Im9yZ19kZXZlbG9wbWVudCJ9.SXWQ9WGmJ-UN7sqCBd3oVhdXfi2rsbFatusjyMvczpM" \
  | python3 -m json.tool

Ожидаемый статус: "status": "completed"

Troubleshooting

❌ "Could not validate credentials"

# Создать новый токен
cd /home/vodorod/dorod/skyvern
.venv/bin/python scripts/create_api_key.py org_development

# Использовать новый токен из output

❌ "Country not supported"

# Проверить прокси в .env
cat /home/vodorod/dorod/skyvern/.env | grep PROXY

# Должно быть:
# HTTP_PROXY=http://user300088:6dwo3v@150.241.224.181:1356
# HTTPS_PROXY=http://user300088:6dwo3v@150.241.224.181:1356

# Перезапустить backend
pkill -9 -f uvicorn
cd /home/vodorod/dorod/skyvern
.venv/bin/python -m uvicorn skyvern.forge.api_app:app --host 0.0.0.0 --port 8000

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

# Проверить порт
ss -tlnp | grep 8000

# Убить процесс если занят
pkill -9 -f "uvicorn skyvern.forge.api_app:app"

# Проверить PostgreSQL
pg_isready -h localhost -p 5433

# Проверить Redis
redis-cli -p 6380 ping

# Запустить снова
cd /home/vodorod/dorod/skyvern
.venv/bin/python -m uvicorn skyvern.forge.api_app:app --host 0.0.0.0 --port 8000

❌ Task fails или timeout

# Увеличить max_steps_per_run
"max_steps_per_run": 100

# Или упростить navigation_goal/data_extraction_goal

Файлы конфигурации

• Environment: /home/vodorod/dorod/skyvern/.env
• Backend logs: /home/vodorod/dorod/skyvern/backend.log
• Database: PostgreSQL localhost:5433
• Redis: localhost:6380

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

• Полная настройка прокси
• Примеры парсинга
• Официальная документация

Порты

• Backend API: 8000
• Frontend (опционально): 5173
• PostgreSQL: 5433
• Redis: 6380

Следующие шаги

1. ✅ Запустить backend
2. ✅ Протестировать простую задачу
3. ⏹️ Создать более сложные парсинг сценарии (см. PARSING-EXAMPLES.md)
4. ⏹️ Интегрировать с n8n для автоматизации
5. ⏹️ Настроить мониторинг задач

---

Статус: ✅ Работает
Последний тест: 2026-02-20
Версия: Skyvern open-source (latest)