File size: 4,358 Bytes
461adca
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
# ✅ Чек-лист розгортання на 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 р.