| # ✅ Чек-лист розгортання на Hugging Face Spaces | |
| ## 📋 Перед розгортанням | |
| - [ ] Переконайтеся, що у вас є доступ до https://huggingface.co/spaces/DocSA/LP_2-test | |
| - [ ] Підготуйте API ключі (хоча б Anthropic) | |
| - [ ] Перевірте, що всі файли актуальні | |
| ## 🔧 Крок 1: Підготовка файлів | |
| ```bash | |
| # Запустіть скрипт підготовки | |
| ./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 | |
| ```bash | |
| # Клонуйте репозиторій | |
| 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 р. | |