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 (рекомендовано)

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

# Відкрийте OpenCode Desktop
open /Applications/OpenCode.app

# Або через термінал
cd /Users/apple/github-projects/microdao-daarion
opencode

---

📱 Як підключити Sofiia до OpenCode:

Крок 1: Відкрийте OpenCode Desktop

open /Applications/OpenCode.app

Крок 2: Додайте API ключі

Відкрийте термінал в OpenCode (Cmd+T) і виконайте:

/connect

Виберіть провайдера:

1. Для GLM5: виберіть Z.AI або введіть API ключ напряму
2. Для Grok: виберіть xAI і введіть ключ

Або скористайтеся скриптом:

# Додати 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 в корені проекту:

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

cd /Users/apple/github-projects/microdao-daarion
opencode

# В OpenCode REPL:
> Яка архітектура проекту DAARION?
> Які основні сервіси в екосистемі?

Тест 2: Через API

# Переконайтеся що сервіс запущено
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. Запитайте: "Яка архітектура проекту?"

---

📊 Моніторинг:

Перевірка логів

# Логи router
docker logs -f dagi-router-node2

# Логи gateway
docker logs -f dagi-gateway-node2

# Логи OpenCode
tail -f ~/.local/share/opencode/log/opencode.log

Перевірка здоров'я сервісів

# Router health
curl http://localhost:9102/health

# Gateway health
curl http://localhost:9300/health

# NATS status
curl http://localhost:8222/varz

---

🔧 Troubleshooting:

Проблема: OpenCode не бачить провайдерів

Рішення:

# Перевірте конфігурацію
cat ~/.config/opencode/opencode.json

# Перевірте авторизацію
opencode auth list

Проблема: Docker сервіси не запускаються

Рішення:

# Перевірте логи
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 ключі не працюють

Рішення:

# Перевірте чи ключі додані
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
• Z.AI GLM-5 API
• xAI Grok API
• DAARION Architecture

---

✅ Чек-лист перед початком роботи:

• OpenCode Desktop відкрито (/Applications/OpenCode.app)
• API ключі додано через /connect або скрипт
• Модель вибрано через /models
• AGENTS.md створено в проекті
• Docker сервіси запущено (опціонально)
• Telegram бот активовано (опціонально)

---

Готово! 🎉 Sofiia налаштована для роботи на NODA2.