microdao-daarion/SOFIIA_NODA2_SETUP.md

# 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.**