Installation

Voraussetzung: Go 1.24+ und mindestens ein erreichbarer Ollama-Server.

git clone https://gitlab.techeve.de/techeve/ollama-agent.git
cd ollama-agent
make build                 # erzeugt bin/ollama-agent

Schnellstart

./bin/ollama-agent config init > config.json   # Beispiel-Config erzeugen
# config.json anpassen: endpoints + models auf die eigene Umgebung
./bin/ollama-agent config validate             # Config prüfen
./bin/ollama-agent endpoints                   # sind die Server erreichbar?
./bin/ollama-agent run "Warum ist der Himmel blau?"

Die Config wird in dieser Reihenfolge gesucht: -config <pfad> → $OLLAMA_AGENT_CONFIG → ./config.json → ~/.ollama-agent/config.json.

Docker

Der Daemon (inkl. Web-UI) läuft als Container — die Konfiguration kommt wahlweise komplett aus Env-Variablen:

docker build -t ollama-agent .
docker run -d --name ollama-agent -p 2330:2330 \
  -v ollama-agent-data:/data \
  -e OLLAMA_URLS=http://192.168.6.80:11434,http://192.168.6.80:11436 \
  -e OLLAMA_DEFAULT_MODEL=qwen3.5:9b \
  ollama-agent

Env-Variable	Bedeutung
OLLAMA_URLS	Komma-Liste der Ollama-Server (Pflicht ohne config.json); erste URL = höchste Priorität
OLLAMA_DEFAULT_MODEL	Standard-Modell (Pflicht ohne config.json)
OLLAMA_AGENT_ADDR	Bind-Adresse, Default 0.0.0.0:2330
OLLAMA_AGENT_TOKEN	optionales Bearer-Token für API/UI
OLLAMA_AGENT_STATE	State-Verzeichnis, Default /data (Sessions, Matrix, Jobs)

Für Task-Zuordnung, Skills, MCP und Cron-Jobs eine vollständige config.json nach /data/config.json mounten — sie gewinnt immer gegen die Env-Variablen. Vorlage: docker-compose.example.yaml.