npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@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/responses und /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 --help

Installation aus dem Repository

npm ci
npm run build
npm run ui:build
npm link
ztn --help

Schnellstart

# Provider anzeigen und anmelden
ztn providers list
ztn login --provider=chatgpt-web

# Modelle aktualisieren
ztn models refresh
ztn models list

# Gateway starten
ztn start

Das 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-4o

Zusätzliche Argumente werden nur nach -- an das Agent-Backend weitergegeben:

ztn agent --model gpt-4o -- --quiet

ztn agent init erzeugt, sofern noch nicht vorhanden:

  • .yoyo.toml mit provider = "custom" und der lokalen FF-ZTN-Gateway-URL
  • .yoyo/instructions.md mit Sicherheits- und Projektregeln

Web-Konsole

npm run ui:build
ztn start

Die 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 public

Der 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.