Some checks failed
Build and Deploy Docs / build-and-deploy (push) Has been cancelled
- Created logs/ structure (sessions, operations, incidents) - Added session-start/log/end scripts - Installed Git hooks for auto-logging commits/pushes - Added shell integration for zsh - Created CHANGELOG.md - Documented today's session (2026-01-10)
5.1 KiB
5.1 KiB
⚡ Sofia Agent - Швидкий старт
✅ Готово до використання!
Sofia Agent працює на вашому MacBook з локальним Ollama.
🚀 Запуск
Варіант 1: Простий запуск (рекомендовано)
cd /Users/apple/github-projects/microdao-daarion
./run_sofia.sh
Варіант 2: З повідомленням
./run_sofia.sh "Привіт Sofia! Розкажи про свою роль"
Варіант 3: Повний контроль
source sofia_venv/bin/activate
python3 sofia_agent.py
💬 Команди в інтерактивному режимі
/help- показати довідку/clear- очистити історію/history- показати історію/exit- вийти
📊 Поточна конфігурація
✅ Працює зараз:
- Модель:
qwen2.5-coder:32b(19 GB) - Провайдер: Ollama (локально)
- URL:
http://localhost:11434 - Python: 3.14.0
- Віртуальне середовище:
sofia_venv/
⏳ Опціонально (майбутнє):
- Grok API (потрібен
XAI_API_KEY) - Голосовий режим (потрібні STT/TTS)
🎯 Приклади
Технічні питання
./run_sofia.sh "Поясни різницю між RAG та fine-tuning"
Планування R&D
./run_sofia.sh "Які напрямки досліджень AI найперспективніші?"
Архітектура
./run_sofia.sh "Як побудувати multi-agent систему?"
Інтерактивний діалог
./run_sofia.sh
🧑 Ви: Привіт Sofia!
🤖 Sofia: Привіт! Я готова допомогти...
🧑 Ви: Які моделі підходять для кодування?
🤖 Sofia: Рекомендую звернути увагу на...
🧑 Ви: /exit
👋 До побачення!
🔧 Додаткові налаштування
Зміна моделі
Відредагуйте .env:
# Для швидшої роботи:
OLLAMA_MODEL=mistral-nemo:12b
# Для складних reasoning задач:
OLLAMA_MODEL=deepseek-r1:70b
# Для мультимодальності (текст + зображення):
OLLAMA_MODEL=llava:13b
Підключення Grok API
# Додати в .env:
XAI_API_KEY=your_xai_api_key_here
XAI_BASE_URL=https://api.x.ai/v1
XAI_MODEL=grok-beta
# Sofia автоматично переключиться на Grok
./run_sofia.sh
# 🤖 Ініціалізація Sofia Agent...
# Режим: Grok API (xAI)
# Модель: grok-beta
🎤 Майбутнє: Голосовий режим
Коли буде готово, додайте в .env:
ENABLE_VOICE_MODE=true
STT_SERVICE_URL=http://144.76.224.179:8895/api
TTS_SERVICE_URL=http://144.76.224.179:5002
Sofia зможе:
- 🎤 Приймати голосові запити (STT)
- 🔊 Відповідати голосом (TTS)
- 💬 Підтримувати текстовий режим паралельно
🐛 Вирішення проблем
"Не можу підключитися до Ollama"
# Перевірити, що Ollama запущено
ps aux | grep ollama
# Якщо ні - запустити
ollama serve
# В новому терміналі:
./run_sofia.sh
"ModuleNotFoundError"
# Переконатися, що використовується venv
source sofia_venv/bin/activate
python3 sofia_agent.py
"Модель не знайдена"
# Перевірити доступні моделі
ollama list
# Завантажити потрібну
ollama pull qwen2.5-coder:32b
📈 Статистика токенів
Sofia показує використання токенів після кожної відповіді:
🤖 Sofia: Відповідь...
[Tokens: ~150]
Це допомагає відстежувати:
- Складність запитів
- Довжину контексту
- Продуктивність моделі
💡 Поради
- Для коротких запитів - використовуйте режим одного повідомлення
- Для діалогу - запускайте інтерактивний режим
- Для складних задач - переключіться на
deepseek-r1:70b - Для швидкості - використовуйте
mistral-nemo:12b
📚 Детальна документація
Див. SOFIA_AGENT_README.md для:
- Повного опису функціоналу
- Всіх доступних моделей
- Інструкцій з Grok API
- Налаштування голосового режиму
✅ Готово!
Sofia Agent працює і готова до роботи! 🚀
Швидкий тест:
./run_sofia.sh "Привіт! Тест зв'язку"