Lokale Installation
Installiere und starte den Stack mit dem Ein-Zeilen-Installer oder klone das Repository und starte ihn selbst.
1. Schnellinstallation mit install.sh
Der Installer lädt das getaggte Release, baut das Image lokal und startet den Stack; Image/Profil wählt der Installer. Erneutes Ausführen aktualisiert direkt vor Ort. Feste Version mit VERSION=0.1.0 sh install.sh.
curl -fsSL https://raw.githubusercontent.com/Arttron/aigentron/main/install.sh | shOder Quellcode klonen (optional)
git clone https://github.com/Arttron/aigentron.git
cd aigentronVoraussetzungen
- Docker Desktop oder Docker Engine + Compose v2 (erforderlich)
- Optional: Ollama läuft auf dem Host (nicht im Container) für die Modellstufe „routine“ — nur eine Anbieteroption, keine Pflicht. Der Orchestrator erreicht sie unter http://host.docker.internal:11434
- ANTHROPIC_API_KEY — erforderlich für die Modellstufe „complex“ (Claude in der Cloud)
- Optional: ein toolfähiges Modell in deinem Host-Ollama (Standard qwen3-coder:30b, festgelegt über ROUTINE_MODEL in .env) — nur wenn du Ollama wählst
- Optional: ein einmalig anzulegendes Docker-Netzwerk, damit Agenten Projektdatenbanken über den Servicenamen erreichen (docker network create lds-agents) — nur für den Compose-/Agent-Workflow
- Wenn du Ollama nutzt, meide qwen2.5-coder — es liefert keine strukturierten Tool-Aufrufe und bringt das Agent-SDK zum Absturz. qwen3-coder:30b ist der unterstützte Standard.
2. Optional: lokale Modelle mit Ollama
Nur wenn du Ollama als Anbieter nutzt. In dein Host-Ollama laden (nicht in einen Container); ROUTINE_MODEL in .env setzen, wenn du ein anderes Modell wählst.
ollama pull qwen3-coder:30b3. Optional: externes Docker-Netzwerk
Einmalige Einrichtung, nur für den Compose-/Agent-Workflow nötig, damit Agenten Projektdatenbanken über den Servicenamen erreichen.
docker network create lds-agents4. Aus dem Quellcode: bauen und starten
Für den Quellcode-Checkout: entspricht docker compose up -d --build. Startet Postgres, Redis, LiteLLM (Anthropic-kompatibler Proxy vor Ollama), den Orchestrator (:3001) und das Dashboard (:3000) — alle per Bind-Mount für Hot-Reload. Der erste Start dauert länger, weil der Orchestrator packages/shared und packages/agent-runner kompiliert, bevor der Healthcheck durchläuft.
make up5. Dashboard öffnen
Dashboard → http://localhost:3000 • Orchestrator-API → http://localhost:3001 Die Standardwerte sind oben angegeben; der Dashboard-Port kann je nach Setup abweichen — lege ihn über das Port-Mapping fest (Compose oder docker run -p). Optional: docker compose --profile mcp up -d für Playwright MCP und einen Dev-Server für Frontend- und Design-Agenten.
Nützlich: make logs | make ps | make migrate | make down | make clean (⚠️ löscht DB-Daten). Ausführlichere Hinweise zu Setup, Modell-Routing und Freigabe-Gate stehen im Repository.
