80 lines
2.0 KiB
Markdown
80 lines
2.0 KiB
Markdown
|
# Archon Kion
|
||
|
|
|
||
|
|
Local AI assistant daemon with Hermes integration. Processes Telegram and Gitea webhooks, routes queries to local Ollama instance.
|
||
|
|
|
||
|
|
## Architecture
|
||
|
|
|
||
|
|
```
|
||
|
|
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
|
||
|
|
│ Telegram │────▶│ Archon Kion │────▶│ Ollama │
|
||
|
|
│ Webhooks │ │ Daemon │ │ localhost │
|
||
|
|
└─────────────┘ └──────┬──────┘ └─────────────┘
|
||
|
|
│
|
||
|
|
┌──────┴──────┐
|
||
|
|
│ Hermes │
|
||
|
|
│ Profile │
|
||
|
|
└─────────────┘
|
||
|
|
```
|
||
|
|
|
||
|
|
## Components
|
||
|
|
|
||
|
|
- **src/main.py**: Daemon entry point, FastAPI web server
|
||
|
|
- **src/ollama_client.py**: Ollama API client
|
||
|
|
- **src/telegram_bot.py**: Telegram webhook handler
|
||
|
|
- **src/hermes_bridge.py**: Hermes profile integration
|
||
|
|
- **config/archon-kion.yaml**: Configuration file
|
||
|
|
- **hermes-profile/profile.yaml**: Thin Hermes profile
|
||
|
|
- **systemd/archon-kion.service**: Systemd service definition
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Clone repository
|
||
|
|
git clone http://143.198.27.163:3000/ezra/archon-kion.git
|
||
|
|
cd archon-kion
|
||
|
|
|
||
|
|
# Install dependencies
|
||
|
|
pip install -r requirements.txt
|
||
|
|
|
||
|
|
# Configure
|
||
|
|
edit config/archon-kion.yaml
|
||
|
|
|
||
|
|
# Run
|
||
|
|
cd src && python main.py
|
||
|
|
```
|
||
|
|
|
||
|
|
## Configuration
|
||
|
|
|
||
|
|
Edit `config/archon-kion.yaml`:
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
ollama:
|
||
|
|
host: localhost
|
||
|
|
port: 11434
|
||
|
|
model: gemma3:4b
|
||
|
|
|
||
|
|
telegram:
|
||
|
|
webhook_url: https://your-domain.com/webhook
|
||
|
|
token: ${TELEGRAM_BOT_TOKEN}
|
||
|
|
|
||
|
|
hermes:
|
||
|
|
profile_path: ./hermes-profile/profile.yaml
|
||
|
|
```
|
||
|
|
|
||
|
|
## Commands
|
||
|
|
|
||
|
|
- `/status` - Check daemon and Ollama status
|
||
|
|
- `/memory` - Show conversation memory
|
||
|
|
- `/query <text>` - Send query to Ollama
|
||
|
|
|
||
|
|
## Testing
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd tests
|
||
|
|
python -m pytest test_archon.py -v
|
||
|
|
```
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
MIT - Hermes Project
|