guilds.run: KI-Agenten lokal im Team betreiben

guilds.run von Cigale AI betreibt dauerhafte Teams von KI-Agenten auf eigener Infrastruktur. Rollen, Modelle und Werkzeuge werden pro Agent festgelegt; gemeinsame Chats, Notizen und Tabellen verbinden die Arbeit.

Einfach erklärt: Wofür ist guilds.run da?

Stell dir eine Werkbank für ein KI-Team vor: Ein Mitglied recherchiert, ein anderes erstellt einen Entwurf, und du prüfst den Ablauf. Ein „Guild“ ist das Team, „Task“ der dauerhafte Arbeitsauftrag und „Run“ eine protokollierte Ausführung. Du siehst den tatsächlichen Prompt, Werkzeugaufrufe und Ergebnisse sowie Änderungen am Gedächtnis.

Das passt zu Entwicklern und Teams, die wiederkehrende Aufgaben schrittweise verbessern wollen. Für einzelne Fragen muss der Aufwand für Installation und Konfiguration mitgerechnet werden.

Lokale Modelle, Kosten und Datenwege

Stand 14. Oktober 2026 ist der selbst betriebene Kern kostenlose Software unter AGPL-3.0-only. Die gehostete Edition ist separat und proprietär; aktuelle buchbare Tarife und Kontingente konnten nicht bestätigt werden. Hardware, externe Werkzeuge und Modellnutzung verursachen gegebenenfalls eigene Kosten.

Unterstützt werden OpenAI, OpenRouter, xAI, DeepInfra und lokale kompatible Endpunkte wie Ollama, LM Studio oder vLLM. Claude und Gemini sind über OpenRouter erreichbar; Kimi Code ist auf Coding-Agenten beschränkt. Die Modell-Dokumentation erklärt: Der Anbieter berechnet die Nutzung dem Inhaber des API-Schlüssels. Guilds setzt kein Ausgabenlimit. Ein fehlender Kostenwert bei lokalen Endpunkten bedeutet keine kostenlose Hardware.

Bei Cloud-Modellen verlassen Anfragen weiterhin den eigenen Rechner. Prüfe auch die Verbindungen zu externen Diensten. Die verlinkten Datenschutz- und Vertragsseiten lieferten bei der Prüfung 404; Aussagen über Aufbewahrung oder Training sind damit nicht belegt. Agenten auf derselben Maschine teilen eine Vertrauensgrenze: Geheimnisse eng zuweisen und bei nötiger Trennung separate Maschinen nutzen.

Vom Docker-Start zur ersten überprüften Antwort

Benötigt werden Docker mit Compose, git und bash. Die Installationsanleitung verwendet:

git clone https://github.com/CigaleAI/guilds.git
cd guilds
./setup.sh
docker compose up --detach --wait

Der erste Build dauert einige Minuten. Bewahre die erzeugte .env mit dem Schlüssel zur Entschlüsselung gespeicherter Zugangsdaten auf. Öffne http://127.0.0.1:8080/.

Verbinde im Willkommensdialog einen Anbieter, wähle Modelle und einen Standard. Erstelle ein Guild, füge einen Agenten hinzu und speichere seinen Task unter Prompt. Teste im Group chat eine kleine Aufgabe. @Agentenname am Anfang weckt dieses Mitglied; ohne Markierung werden alle geweckt. Öffne Inspect run und prüfe den Auftrag und die Schritte. Eine Folgefrage und die Speicher-Version unter State zeigen, ob Kontext erhalten wurde.

Docker-127.0.0.1 bezeichnet den Container. Ein Modellserver auf dem Host benötigt eine erreichbare Adresse, unter Docker Desktop beispielsweise host.docker.internal. Fernzugriff ist eine separate Konfiguration.

Rollen und gemeinsame Arbeitsgrundlagen

Notizen speichern Regeln und Erkenntnisse, Tabellen strukturierte Datensätze, Skripte wiederholbare Verarbeitung. Individuelles Gedächtnis ergänzt den Kontext späterer Runs. Definiere Eingabe, Ergebnis und erlaubte Aktionen pro Rolle.

Connectoren können lokale Adapter oder MCP-Endpunkte sein. Gmail, Drive und GitHub brauchen zusätzliche Einrichtung von Anwendungen und Zugangsdaten. Werkzeuge lassen sich auf Organisations-, Guild- und Agentenebene begrenzen; ein Logo auf der Website ersetzt diese Einrichtung nicht.

Fehler verfolgen und Studio-Änderungen prüfen

Inspect run zeigt, ob ein Fehler im Task, den Werkzeugdaten oder im Gedächtnis liegt. Prompt Studio untersucht vorhandene Teamdaten und entwirft Task-Änderungen. Du prüfst den Unterschied und veröffentlichst oder verwirfst ihn. Der Coach veröffentlicht nicht selbst; Änderungen betreffen neue Runs, alte Protokolle bleiben erhalten.

Zeitpläne und Recipes wiederverwenden

Routines lassen sich pausieren. Cron verwendet UTC und mindestens fünf Minuten zwischen Auslösungen. Recipes exportieren Teamkonfiguration als JSON: speichern, freigeben, exportieren; nach Import den Erstellungsplan prüfen, Anmeldungen ergänzen und Zeitpläne aktivieren. Schlüssel, Chatverlauf, Gedächtnis, Tabellendaten und Browserprofile werden nicht übernommen. Das öffentliche Recipe-Verzeichnis ist noch angekündigt.

Häufige Fragen

Ist der Betrieb vollständig kostenlos?

Der Softwarekern ist kostenlos. Modellanbieter, Hardware und externe Dienste werden separat bezahlt; Ausgabenlimits musst du beim Anbieter setzen.

Bleiben mit einem lokalen Modell alle Daten lokal?

Der kompatible lokale Endpunkt ist möglich. Externe Werkzeuge und Cloud-Verbindungen müssen trotzdem geprüft werden; vollständige Datenschutzbedingungen waren nicht verfügbar.

Kann ich sehen, wie ein Agent gearbeitet hat?

Ja. Inspect run zeigt den tatsächlichen Prompt sowie Werkzeugaufrufe und Ergebnisse. Speicher-Versionen helfen beim Nachverfolgen des Kontexts, ohne korrekte Antworten zu garantieren.

Offizielle Ressourcen

• Dokumentation: Installation und Betrieb.
• Quellcode und Issues: Umsetzung und Lizenz.
• Offizielles X-Konto: Ankündigungen.
• Verlinkte Discord-Community: gegebenenfalls Mitgliedschaft erforderlich.