chore(infra): add NODA2 setup files, docker-compose configs and root config
- AGENTS.md: Sofiia Chief AI Architect role definition - SOFIIA_IN_OPENCODE.md, SOFIIA_NODA2_SETUP.md: NODA2 setup documentation - agromatrix_stepan_noda1_APPLY.md, agromatrix_stepan_noda1_prod.patch: AgroMatrix production patch - docker-compose.memory-node2.yml: memory service for NODA2 - docker-compose.node2-sofiia-supervisor.yml: sofiia supervisor for NODA2 - gateway-bot/gateway_boot.py, monitor_prompt.txt, vision_guard.py: gateway extras - models/Modelfile.qwen3.5-35b-a3b: Qwen model definition for NODA3 - opencode.json: OpenCode providers and agents config - scripts/init-sofiia-memory.py, scripts/node2/*, start-memory-node2.sh: NODA2 init scripts - setup_sofiia_node2.sh: NODA2 full setup script Made-with: Cursor
This commit is contained in:
Apple
264
SOFIIA_NODA2_SETUP.md
Normal file
264
SOFIIA_NODA2_SETUP.md
Normal file
@@ -0,0 +1,264 @@
|
||||
# Sofiia NODA2 Setup Guide
|
||||
|
||||
## ✅ Що вже зроблено:
|
||||
|
||||
1. **GLM5 API налаштовано в OpenCode**
|
||||
- Провайдер: `zai` (Z.AI GLM-5)
|
||||
- API Key додано в конфігурацію
|
||||
|
||||
2. **Grok API налаштовано в OpenCode**
|
||||
- Провайдер: `xai` (xAI Grok)
|
||||
- API Key додано в конфігурацію
|
||||
- Модель: `grok-2-1212` для Sofiia
|
||||
|
||||
3. **Sofiia налаштована в agent_registry.yml**
|
||||
- LLM Profile змінено з `reasoning` на `grok`
|
||||
- Telegram токен додано в .env
|
||||
|
||||
4. **API ключі додано в .env:**
|
||||
- `XAI_API_KEY` для Grok
|
||||
- `SOFIIA_TELEGRAM_BOT_TOKEN` для Telegram бота
|
||||
- `GLM5_API_KEY` для GLM5
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Як запустити Sofiia на NODA2:
|
||||
|
||||
### Спосіб 1: Через Docker (рекомендовано)
|
||||
|
||||
```bash
|
||||
cd /Users/apple/github-projects/microdao-daarion
|
||||
|
||||
# Запустити сервіси
|
||||
docker-compose -f docker-compose.node2-sofiia.yml up -d
|
||||
|
||||
# Перевірити статус
|
||||
docker-compose -f docker-compose.node2-sofiia.yml ps
|
||||
|
||||
# Переглянути логи
|
||||
docker-compose -f docker-compose.node2-sofiia.yml logs -f router
|
||||
```
|
||||
|
||||
### Спосіб 2: Напряму через OpenCode Desktop
|
||||
|
||||
```bash
|
||||
# Відкрийте OpenCode Desktop
|
||||
open /Applications/OpenCode.app
|
||||
|
||||
# Або через термінал
|
||||
cd /Users/apple/github-projects/microdao-daarion
|
||||
opencode
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📱 Як підключити Sofiia до OpenCode:
|
||||
|
||||
### Крок 1: Відкрийте OpenCode Desktop
|
||||
|
||||
```bash
|
||||
open /Applications/OpenCode.app
|
||||
```
|
||||
|
||||
### Крок 2: Додайте API ключі
|
||||
|
||||
Відкрийте термінал в OpenCode (Cmd+T) і виконайте:
|
||||
|
||||
```
|
||||
/connect
|
||||
```
|
||||
|
||||
Виберіть провайдера:
|
||||
1. Для GLM5: виберіть **Z.AI** або введіть API ключ напряму
|
||||
2. Для Grok: виберіть **xAI** і введіть ключ
|
||||
|
||||
Або скористайтеся скриптом:
|
||||
|
||||
```bash
|
||||
# Додати GLM5 API ключ
|
||||
opencode auth add zai --key "2f32adb611c54ccf9808062c4442c2b2.Q0BgNNlmH9O9iPGe"
|
||||
|
||||
# Додати xAI Grok API ключ
|
||||
opencode auth add xai --key "xai-VsaJjtIDhQdMlez7jRrQ93uAvqBWi0UNrdDhpUO58tnKMgjIp6P0BF6HGWrLe2QXezyvJnjCUD7C9gQ7"
|
||||
```
|
||||
|
||||
### Крок 3: Виберіть модель для Sofiia
|
||||
|
||||
В OpenCode виконайте:
|
||||
|
||||
```
|
||||
/models
|
||||
```
|
||||
|
||||
Виберіть:
|
||||
- `xai/grok-2-1212` для Sofiia (рекомендовано)
|
||||
- Або `zai/glm-5` для GLM5
|
||||
|
||||
### Крок 4: Налаштуйте агент Sofiia
|
||||
|
||||
Створіть файл `AGENTS.md` в корені проекту:
|
||||
|
||||
```bash
|
||||
cd /Users/apple/github-projects/microdao-daarion
|
||||
cat > AGENTS.md << 'EOF'
|
||||
# DAARION Project - Sofiia Agent
|
||||
|
||||
## Agent: Sofiia (Chief AI Architect)
|
||||
|
||||
### Description
|
||||
Sofiia is the Chief AI Architect and Technical Sovereign of the DAARION.city ecosystem.
|
||||
She coordinates R&D, architecture, security, and platform evolution.
|
||||
|
||||
### Capabilities
|
||||
- Architecture design and review
|
||||
- AI research and development
|
||||
- Security analysis
|
||||
- Platform evolution planning
|
||||
- Technical leadership
|
||||
|
||||
### LLM Configuration
|
||||
- Primary: Grok 2 (grok-2-1212)
|
||||
- Fallback: DeepSeek Chat
|
||||
|
||||
### Usage
|
||||
Sofiia can be invoked through:
|
||||
1. OpenCode Desktop: Use Grok model
|
||||
2. Telegram: @SofiiaDAARION_bot (NODA2)
|
||||
3. API: POST http://localhost:9102/v1/agents/sofiia/infer
|
||||
|
||||
### Example Commands
|
||||
- "Review the architecture of the authentication module"
|
||||
- "Suggest improvements for the router service"
|
||||
- "Analyze security vulnerabilities in the gateway"
|
||||
EOF
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🧪 Тестування Sofiia:
|
||||
|
||||
### Тест 1: Через OpenCode CLI
|
||||
|
||||
```bash
|
||||
cd /Users/apple/github-projects/microdao-daarion
|
||||
opencode
|
||||
|
||||
# В OpenCode REPL:
|
||||
> Яка архітектура проекту DAARION?
|
||||
> Які основні сервіси в екосистемі?
|
||||
```
|
||||
|
||||
### Тест 2: Через API
|
||||
|
||||
```bash
|
||||
# Переконайтеся що сервіс запущено
|
||||
curl -X POST http://localhost:9102/v1/agents/sofiia/infer \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"message": "Описати архітектуру проекту DAARION",
|
||||
"context": {
|
||||
"system_prompt": "Ти Sofiia, Chief AI Architect екосистеми DAARION.city"
|
||||
}
|
||||
}'
|
||||
```
|
||||
|
||||
### Тест 3: Через Telegram
|
||||
|
||||
1. Знайдіть бота: @SofiiaDAARION_bot (або створіть нового з токеном)
|
||||
2. Надішліть повідомлення: `/start`
|
||||
3. Запитайте: "Яка архітектура проекту?"
|
||||
|
||||
---
|
||||
|
||||
## 📊 Моніторинг:
|
||||
|
||||
### Перевірка логів
|
||||
|
||||
```bash
|
||||
# Логи router
|
||||
docker logs -f dagi-router-node2
|
||||
|
||||
# Логи gateway
|
||||
docker logs -f dagi-gateway-node2
|
||||
|
||||
# Логи OpenCode
|
||||
tail -f ~/.local/share/opencode/log/opencode.log
|
||||
```
|
||||
|
||||
### Перевірка здоров'я сервісів
|
||||
|
||||
```bash
|
||||
# Router health
|
||||
curl http://localhost:9102/health
|
||||
|
||||
# Gateway health
|
||||
curl http://localhost:9300/health
|
||||
|
||||
# NATS status
|
||||
curl http://localhost:8222/varz
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Troubleshooting:
|
||||
|
||||
### Проблема: OpenCode не бачить провайдерів
|
||||
|
||||
**Рішення:**
|
||||
```bash
|
||||
# Перевірте конфігурацію
|
||||
cat ~/.config/opencode/opencode.json
|
||||
|
||||
# Перевірте авторизацію
|
||||
opencode auth list
|
||||
```
|
||||
|
||||
### Проблема: Docker сервіси не запускаються
|
||||
|
||||
**Рішення:**
|
||||
```bash
|
||||
# Перевірте логи
|
||||
docker-compose -f docker-compose.node2-sofiia.yml logs
|
||||
|
||||
# Перевірте змінні середовища
|
||||
docker-compose -f docker-compose.node2-sofiia.yml config
|
||||
|
||||
# Перезапустіть
|
||||
docker-compose -f docker-compose.node2-sofiia.yml restart
|
||||
```
|
||||
|
||||
### Проблема: API ключі не працюють
|
||||
|
||||
**Рішення:**
|
||||
```bash
|
||||
# Перевірте чи ключі додані
|
||||
grep -E "XAI_API_KEY|SOFIIA_TELEGRAM_BOT_TOKEN|GLM5_API_KEY" \
|
||||
/Users/apple/github-projects/microdao-daarion/.env
|
||||
|
||||
# Якщо немає - запустіть скрипт знову
|
||||
bash /Users/apple/github-projects/microdao-daarion/setup_sofiia_node2.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📚 Додаткові ресурси:
|
||||
|
||||
- [OpenCode Documentation](https://opencode.ai/docs)
|
||||
- [Z.AI GLM-5 API](https://z.ai)
|
||||
- [xAI Grok API](https://console.x.ai)
|
||||
- [DAARION Architecture](/Users/apple/github-projects/microdao-daarion/docs/NODA1-AGENT-ARCHITECTURE.md)
|
||||
|
||||
---
|
||||
|
||||
## ✅ Чек-лист перед початком роботи:
|
||||
|
||||
- [ ] OpenCode Desktop відкрито (/Applications/OpenCode.app)
|
||||
- [ ] API ключі додано через `/connect` або скрипт
|
||||
- [ ] Модель вибрано через `/models`
|
||||
- [ ] AGENTS.md створено в проекті
|
||||
- [ ] Docker сервіси запущено (опціонально)
|
||||
- [ ] Telegram бот активовано (опціонально)
|
||||
|
||||
---
|
||||
|
||||
**Готово! 🎉 Sofiia налаштована для роботи на NODA2.**
|
||||
Reference in New Issue
Block a user