Files

Apple 5290287058 feat: implement TTS, Document processing, and Memory Service /facts API

- TTS: xtts-v2 integration with voice cloning support
- Document: docling integration for PDF/DOCX/PPTX processing
- Memory Service: added /facts/upsert, /facts/{key}, /facts endpoints
- Added required dependencies (TTS, docling)

2026-01-17 08:16:37 -08:00

5.1 KiB

Raw Permalink Blame History

🤖 Повний гайд: Запуск агента Helion на НОДА1

Дата: 2026-01-12
Мета: Запустити Telegram бота Helion на НОДА1 через Gateway сервіс

📋 Що таке Helion?

Helion - це Telegram бот агент платформи Energy Union, який працює через Gateway сервіс.

Характеристики:

Token: 8112062582:AAGS-HwRLEI269lDutLtAJTFArsIq31YNhE
Bot ID: 8112062582
Prompt: gateway-bot/helion_prompt.txt
Webhook: https://gateway.daarion.city/8112062582/telegram/webhook
Роль: Центральний інтелектуальний агент платформи Energy Union

Сфери роботи:

Енергетичні технології (EcoMiner/SES-77, BioMiner, Biochar)
Токеноміка (ENERGY, 1T, kWt, NFT)
DAO governance (структура, голосування, ролі)
Технічна документація та підтримка користувачів

🔧 Що потрібно для запуску

1. Gateway сервіс

Gateway-bot сервіс обробляє webhook запити від Telegram та маршрутизує їх до Router.

Потрібно:

Gateway-bot контейнер запущений
Порт 9300 відкритий
З'єднання з Router (http://router:9102)
З'єднання з Memory Service (http://memory-service:8000)

2. Змінні середовища

HELION_TELEGRAM_BOT_TOKEN=8112062582:AAGI7tPFo4gvZ6bfbkFu9miq5GdAH2_LvcM
HELION_NAME=Helion
HELION_PROMPT_PATH=/app/gateway-bot/helion_prompt.txt

3. Файли

gateway-bot/helion_prompt.txt - системний prompt для Helion
gateway-bot/ - директорія з кодом Gateway
gateway-bot/Dockerfile - Dockerfile для збірки

4. Залежності

✅ Router (вже працює на НОДА1)
⚠️ Memory Service (потрібно перевірити)
✅ NATS (вже працює на НОДА1)

🚀 План дій

Крок 1: Перевірити наявність Gateway на НОДА1

ssh root@144.76.224.179
ls -la /opt/microdao-daarion/gateway-bot/

Крок 2: Додати Gateway в docker-compose.node1.yml

Потрібно додати сервіс gateway до docker-compose.node1.yml:

gateway:
  build:
    context: ./gateway-bot
    dockerfile: Dockerfile
  container_name: dagi-gateway-node1
  ports:
    - "9300:9300"
  environment:
    - ROUTER_URL=http://router:9102
    - HELION_TELEGRAM_BOT_TOKEN=8112062582:AAGS-HwRLEI269lDutLtAJTFArsIq31YNhE
    - HELION_NAME=Helion
    - HELION_PROMPT_PATH=/app/gateway-bot/helion_prompt.txt
    - MEMORY_SERVICE_URL=http://memory-service:8000
  volumes:
    - ./gateway-bot:/app/gateway-bot:ro
    - ./logs:/app/logs
  depends_on:
    - router
  networks:
    - dagi-network
  restart: unless-stopped
  healthcheck:
    test: ["CMD", "curl", "-f", "http://localhost:9300/health"]
    interval: 30s
    timeout: 10s
    retries: 3

Крок 3: Завантажити gateway-bot на НОДА1

Якщо gateway-bot немає на НОДА1, потрібно завантажити:

# З локальної машини
scp -r gateway-bot root@144.76.224.179:/opt/microdao-daarion/

Крок 4: Запустити Gateway

ssh root@144.76.224.179
cd /opt/microdao-daarion
docker compose -f docker-compose.node1.yml up -d gateway

Крок 5: Перевірити статус

docker ps | grep gateway
curl http://localhost:9300/health

Крок 6: Налаштувати Telegram webhook

curl -X POST "https://api.telegram.org/bot8112062582:AAGS-HwRLEI269lDutLtAJTFArsIq31YNhE/setWebhook" \
  -d "url=https://gateway.daarion.city/8112062582/telegram/webhook"

📝 Детальна інформація

Gateway архітектура

Gateway приймає webhook запити від Telegram
Маршрутизує їх до Router через /route endpoint
Router обробляє запити та повертає відповіді
Gateway відправляє відповіді назад в Telegram

Helion інтеграція

Helion використовує той самий Gateway, що й DAARWIZZ
Відрізняється тільки токеном та prompt файлом
Може працювати одночасно з іншими ботами

⚠️ Потенційні проблеми

1. Memory Service не запущений

Якщо Memory Service не запущений, Gateway все одно працюватиме, але без збереження пам'яті.

2. Router недоступний

Gateway не зможе маршрутизувати запити, потрібно перевірити Router.

3. Webhook не налаштований

Telegram не зможе надсилати повідомлення, потрібно налаштувати webhook.

Оновлено: 2026-01-12

5.1 KiB Raw Permalink Blame History Unescape Escape