jensbot-nexus

Persönlicher KI-Agent mit Chat, Telegram, Dashboard, Scheduler, iOS-App und Obsidian-Vault.

Struktur

Ordner	Inhalt
agent/	Python-Agent (jensbot) – CLI, Telegram, Tools, Shared Memory, RAG
backend/	JensNexus Backend (FastAPI) – WebSocket-Chat, Dashboard-API
ios/	JensNexus SwiftUI-App für iPhone/iPad
vault/	Obsidian-Vault für Menschen-Sicht (Brain, Skills, Routinen)

Schnellstart

# Agent
cd agent
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
cp config.yaml.example config.yaml   # ← Secrets eintragen!
jensbot run

# Backend
cd backend
pip install -r requirements.txt
python -m backend.main

# iOS
open ios/JensNexus.xcodeproj

Voraussetzungen

• Python 3.11+
• macOS 14+ (für iOS-App: Xcode 16+)
• Optional: Ollama (für lokale Embeddings), Home Assistant, cTrader
• Provider: Hyper oder OpenRouter

Config

agent/config.yaml (aus config.yaml.example kopieren):

• providers.hyper.api_key / providers.openrouter.api_key – API-Keys
• telegram.token / telegram.allowed_chat_ids – Telegram-Bot
• homeassistant.url / homeassistant.token – Smart Home (optional)

Lizenz

MIT## Optionale Komponenten

Piper TTS (Sprachausgabe)

# Stimme runterladen
mkdir -p vault/config/voices
curl -L -o vault/config/voices/de_DE-thorsten-medium.onnx \
  https://huggingface.co/rhasspy/piper-voices/resolve/main/de/de_DE/thorsten/medium/de_DE-thorsten-medium.onnx
curl -L -o vault/config/voices/de_DE-thorsten-medium.onnx.json \
  https://huggingface.co/rhasspy/piper-voices/resolve/main/de/de_DE/thorsten/medium/de_DE-thorsten-medium.onnx.json