@forgefabrik/ff-ztn
v0.3.0
Published
ForgeFabrik Zero Token Nova – Enterprise Multi-Provider AI Control Plane
Readme
FF-ZTN
ForgeFabrik Zero Token Nova ist ein lokales Enterprise Multi-Provider AI Control Plane mit OpenAI-kompatiblem Gateway, Provider-Runtime, Web-Konsole, Playground und optionalem Coding-Agent.
Hinweis: FF-ZTN ist ein inoffizielles, experimentelles Werkzeug. Es ist kein Produkt von OpenAI, Anthropic, Google oder einem anderen unterstützten Anbieter.
Funktionen
- Multi-Provider-Gateway für ChatGPT Web, Claude Web, Gemini Web, DeepSeek, Qwen, GLM und weitere Provider
- OpenAI-kompatible Endpunkte für
/v1/models,/v1/responsesund/v1/chat/completions - Enterprise Web-Konsole mit dichten Provider-, Account- und Modelllisten
- Persistentes Terminal-Dock mit CLI-, Live-Log- und Login-Job-Tabs
- FF-ZTN Agent als Integration des MIT-lizenzierten Projekts
yoyo-evolve - Lokale Speicherung mit restriktiven Dateiberechtigungen und redigierter Admin-API
- Einheitlicher CLI-Befehl: ausschließlich
ztn
Voraussetzungen
- Node.js
>= 22.15.0 - npm oder pnpm
- Chrome oder Chromium für Web-Logins
- optional Rust/Cargo für den Coding-Agent
Installation über npm
npm install --global @forgefabrik/ff-ztn
ztn --helpInstallation aus dem Repository
npm ci
npm run build
npm run ui:build
npm link
ztn --helpSchnellstart
# Provider anzeigen und anmelden
ztn providers list
ztn login --provider=chatgpt-web
# Modelle aktualisieren
ztn models refresh
ztn models list
# Gateway starten
ztn startDas Gateway bindet standardmäßig an 127.0.0.1:3000.
FF-ZTN Agent
FF-ZTN integriert yoyo-evolve als separates Agent-Backend. Der Rust-Quellbaum wird nicht dupliziert. Stattdessen startet FF-ZTN das installierte yoyo-Binary mit dessen custom-Provider gegen das lokale OpenAI-kompatible Gateway.
# yoyo-agent über Cargo installieren
ztn agent install
# Projektkonfiguration erzeugen
ztn agent init
# Binary und Gateway prüfen
ztn agent doctor
# Agent starten
ztn agent --model gpt-4oZusätzliche Argumente werden nur nach -- an das Agent-Backend weitergegeben:
ztn agent --model gpt-4o -- --quietztn agent init erzeugt, sofern noch nicht vorhanden:
.yoyo.tomlmitprovider = "custom"und der lokalen FF-ZTN-Gateway-URL.yoyo/instructions.mdmit Sicherheits- und Projektregeln
Web-Konsole
npm run ui:build
ztn startDie Web-Konsole enthält:
- Streaming-Playground
- Provider-Runtime-Matrix mit kleinen Statusdioden
- persistente Filter, Navigation und Tabellenansichten
- Account- und Session-Verwaltung
- Modellfilter und Cache-Aktualisierung
- ausfahrbares Terminal-Dock für CLI, Live-Logs und Login-Jobs
- sichere, redigierte Konfigurationsansicht
Konfiguration und Migration
Bestehende interne Datenpfade bleiben absichtlich kompatibel, damit Accounts, Sessions und Browserprofile bei der Umbenennung nicht verloren gehen:
~/.config/nova/Ein älterer Datenordner unter ~/.config/zero-token/ wird weiterhin erkannt. Ein expliziter Pfad kann mit NOVA_HOME gesetzt werden. Diese internen Kompatibilitätsnamen ändern nicht den öffentlichen CLI-Befehl ztn.
npm-Veröffentlichung
Der Workflow .github/workflows/npm-publish.yml führt vor jeder Veröffentlichung aus:
npm ci
npm run typecheck
npm test
npm run build
npm run ui:build
npm pack --dry-run
npm publish --access publicDer Standardname ist @forgefabrik/ff-ztn. Beim manuellen Workflow-Start kann alternativ der Scope osteyshoit gewählt werden. Der Registry-Token wird ausschließlich als GitHub-Actions-Secret NPM_TOKEN verwendet.
Sicherheit
- Passwörter werden nicht gespeichert
- Cookies, Tokens und API-Schlüssel werden nicht im Frontend angezeigt
- sensible Werte müssen aus Logs redigiert werden
- Account-Dateien verwenden restriktive Berechtigungen (
0600) - das Gateway ist standardmäßig nur lokal erreichbar
- der Agent erhält keine Browser-Cookies oder Account-Dateien, sondern nur Zugriff auf das lokale
/v1-Gateway
Drittanbieter
FF-ZTN integriert das eigenständige Projekt yoyo-evolve von yologdev als optionales ausführbares Backend. Das Projekt steht unter der MIT-Lizenz. Details stehen in THIRD_PARTY_NOTICES.md.
Lizenz
FF-ZTN steht unter der MIT-Lizenz.
Implementierungsplan
Der bestehende Architektur- und Implementierungsplan befindet sich unter docs/zero-token/impl-plan.md. Historische Pfade bleiben während der Migration bestehen.
