# 🖥️ Sofia CLI - Complete Guide

## ✅ Доступні CLI інтерфейси

### 1. Python CLI (Найкращий) ⭐

**Використання:**
```bash
# Інтерактивний режим
./run_sofia.sh

# Або через venv
source sofia_venv/bin/activate
python3 sofia_agent.py

# Одне питання
python3 sofia_agent.py "Твоє питання тут"
```

**Переваги:**
- ✅ Працює стабільно
- ✅ Історія розмов
- ✅ Статистика токенів
- ✅ Підтримка Grok API + Ollama

**Команди в інтерактивному режимі:**
- `/help` - довідка
- `/clear` - очистити історію
- `/history` - показати історію
- `/exit` - вийти

---

### 2. Web Interface (Візуальний) 🌐

**Запуск:**
```bash
./start_sofia.sh
```

**URL:**
```
http://localhost:5173/sofia
```

**Переваги:**
- ✅ Красивий UI
- ✅ Градієнтний дизайн
- ✅ Швидкі запити
- ✅ Responsive

---

### 3. AIChat CLI (Альтернативний)

**Встановлено:** ✅ `aichat`

**Конфігурація:**
- Config: `~/.config/aichat/config.yaml`
- Role: `~/.config/aichat/roles/sofia.md`

**Використання:**
```bash
aichat --role sofia
```

**Aliases (додані в ~/.zshrc):**
```bash
sofia              # aichat --role sofia
sofia-chat         # aichat --role sofia
sofia-quick        # aichat --role sofia --no-stream
```

**Примітка:** Потребує додаткової ініціалізації при першому запуску.

---

### 4. LLM CLI (від Simon Willison)

**Встановлено:** ✅ `llm` + `llm-ollama` plugin

**Template:** `~/.config/llm/templates/sofia.txt`

**Використання:**
```bash
# Одне питання
llm -m ollama/qwen2.5-coder:32b -s "$(cat ~/.config/llm/templates/sofia.txt)" "Твоє питання"

# Чат
llm chat -m ollama/qwen2.5-coder:32b -s "$(cat ~/.config/llm/templates/sofia.txt)"
```

**Примітка:** Може мати проблеми з шаблонами Ollama.

---

## 🎯 Рекомендації

### Для щоденного використання:
```bash
# В терміналі
./run_sofia.sh

# В браузері
./start_sofia.sh
# Відкрити: http://localhost:5173/sofia
```

### Для швидких запитів:
```bash
python3 sofia_agent.py "Швидке питання"
```

### Для візуального досвіду:
```
http://localhost:5173/sofia
```

---

## 📊 Порівняння CLI

| Особливість | Python CLI | Web UI | aichat | llm |
|-------------|------------|--------|--------|-----|
| **Стабільність** | ✅ | ✅ | ⚠️ | ⚠️ |
| **Історія** | ✅ | ✅ | ✅ | ⚠️ |
| **Токени** | ✅ | ✅ | ❌ | ❌ |
| **Grok API** | ✅ | ✅ | ✅ | ✅ |
| **Візуалізація** | ❌ | ✅ | ❌ | ❌ |
| **Швидкість** | ⚡⚡ | ⚡ | ⚡⚡ | ⚡⚡ |
| **Кольори** | ❌ | ✅ | ✅ | ❌ |

---

## 🚀 Швидкий старт

### Для нових користувачів:

**1. Спробувати CLI:**
```bash
cd /Users/apple/github-projects/microdao-daarion
./run_sofia.sh
```

**2. Спробувати Web UI:**
```bash
./start_sofia.sh
```

Браузер автоматично відкриється на `http://localhost:5173/sofia`

---

## 🔧 Конфігурація

### Всі CLI використовують:
- `.env` файл для API ключів
- Ollama на `localhost:11434`
- Модель: `qwen2.5-coder:32b`

### Зміна моделі:
```bash
# В .env
OLLAMA_MODEL=deepseek-r1:70b
```

### Підключення Grok:
```bash
# В .env
XAI_API_KEY=your_key_here
```

---

## 📱 Додаткові можливості

### Python CLI:
- Асинхронна обробка
- Збереження історії в пам'яті
- Статистика токенів
- Fallback до локальної моделі

### Web UI:
- Швидкі запити (quick actions)
- Градієнтний дизайн
- Автоскрол
- Очистити чат

### AIChat:
- Syntax highlighting
- Code block підсвітка
- Emacs keybindings
- Compression

### LLM CLI:
- Plugin ecosystem
- Multiple models
- Templates system
- Conversation management

---

## 🎨 Кастомізація

### Sofia Prompt можна змінити в:
- Python: `sofia_agent.py` → `SOFIA_SYSTEM_PROMPT`
- Web: `sofia_api.py` → `SOFIA_SYSTEM_PROMPT`
- AIChat: `~/.config/aichat/roles/sofia.md`
- LLM: `~/.config/llm/templates/sofia.txt`

---

## 💡 Поради

1. **Python CLI** - найстабільніший варіант
2. **Web UI** - найкрасивіший
3. **aichat** - найбільше функцій
4. **llm** - найпростіший для скриптів

**Використовуйте той, що вам зручніший!** 🚀

---

## 📚 Документація

- `SOFIA_QUICKSTART.md` - швидкий старт
- `SOFIA_AGENT_README.md` - повна документація Python CLI
- `SOFIA_WEB_UI.md` - веб-інтерфейс
- `SOFIA_CLI.md` - цей файл

---

## ✅ Готово!

Всі CLI встановлені та налаштовані для Sofia! 🎉

**Рекомендую почати з:**
```bash
./run_sofia.sh
```