HF_DEPLOYMENT_CHECKLIST.md

✅ Чек-лист розгортання на Hugging Face Spaces

📋 Перед розгортанням

• Переконайтеся, що у вас є доступ до https://huggingface.co/spaces/DocSA/LP_2-test
• Підготуйте API ключі (хоча б Anthropic)
• Перевірте, що всі файли актуальні

🔧 Крок 1: Підготовка файлів

# Запустіть скрипт підготовки
./prepare_hf_deploy.sh

• Скрипт виконався без помилок
• Створена папка hf_deploy/
• Файл FILES_LIST.txt містить всі необхідні файли

📤 Крок 2: Завантаження на HF Spaces

Варіант A: Через веб-інтерфейс

1. Відкрийте https://huggingface.co/spaces/DocSA/LP_2-test
2. Files > Add file > Upload files
3. Виберіть всі файли з папки hf_deploy/
4. Commit changes

Варіант B: Через Git

# Клонуйте репозиторій
git clone https://huggingface.co/spaces/DocSA/LP_2-test
cd LP_2-test

# Очистіть старі файли (якщо потрібно)
rm -rf *

# Скопіюйте нові файли
cp -r ../hf_deploy/* ./

# Закомітьте
git add .
git commit -m "Deploy: version X.X.X"
git push

• Файли завантажені
• Git push пройшов успішно

🔐 Крок 3: Налаштування секретів

1. Перейдіть Settings > Variables and secrets
2. Додайте змінні:

ANTHROPIC_API_KEY=sk-ant-xxxxx
OPENAI_API_KEY=sk-xxxxx (опціонально)
GEMINI_API_KEY=xxxxx (опціонально)

3. Збережіть зміни

📊 Крок 4: Налаштування індексів

Варіант A: Локальні індекси

• Запакуйте Save_Index_Ivan/ в tar.gz
• Завантажте на HF Space
• Розпакуйте через terminal або скрипт

Варіант B: AWS S3

• Налаштуйте AWS credentials в Secrets:

  AWS_ACCESS_KEY_ID=xxxxx
  AWS_SECRET_ACCESS_KEY=xxxxx
  

• Індекси завантажаться автоматично при старті

🚀 Крок 5: Запуск та тестування

1. Space автоматично перезапустився
2. Немає помилок в логах (Logs tab)
3. Інтерфейс відкривається
4. Протестуйте функції:
   • Генерація правової позиції
   • Пошук прецедентів
   • Аналіз релевантності

🔍 Крок 6: Перевірка налаштувань

• Default provider: Anthropic
• Default model: Claude Sonnet 4.5
• Max tokens: 512
• Temperature: 0.5

📝 Крок 7: Документація

• README.md відображається правильно
• Вкладка "Допомога" працює
• API instructions зрозумілі

⚠️ Усунення проблем

Якщо Space не запускається:

1. Перевірте Logs на помилки
2. Переконайтеся, що всі файли завантажені
3. Перевірте, що API ключі правильно налаштовані
4. Factory reboot Space

Якщо є помилки імпорту:

1. Перевірте requirements.txt
2. Переконайтеся, що папка config/ повна
3. Перевірте структуру директорій

✅ Фінальна перевірка

• Space статус: Running (зелений)
• Інтерфейс відповідає за < 5 секунд
• Генерація працює з вашим API ключем
• Пошук повертає результати
• Аналіз виконується коректно
• Немає критичних помилок в логах

🎉 Готово!

Space розгорнуто та працює: https://huggingface.co/spaces/DocSA/LP_2-test

---

Версія: 1.0.0
Дата: 10 лютого 2026 р.