Pro
DE
AnmeldenKonto Für Mac herunterladen
Für Mac herunterladen

Doku / API und Agenten

Claude, Codex und MCP: Agent-Tools

Phosphene ist ein lokaler Server (das Studio), mit dem die Browser-Seite, die Mac-App und Agenten-Werkzeuge über dieselbe HTTP-API sprechen (API.md). Zwei kleine Werkzeuge setzen darauf auf, in agents/:

wasausführen mit
agents/phosphene_cli.pyder Befehl phosphene: Video / Bilder / Sprache / Musik machen, Aufträge auflisten, warten, Dateien abholen, Statusjedem python3 (3.9+, nur Standardbibliothek)
agents/phosphene_mcp.pyein MCP-Server (stdio) mit denselben Aktionen, für Claude Code, Codex oder jeden MCP-Clientdasselbe

Beide sind dünne Schichten über agents/phosphene_client.py, finden das Studio also auf dieselbe Weise und sagen dasselbe, wenn es nicht läuft.

Einen Agenten verbinden

Mac-App (5.0.9 oder neuer): Öffne Phosphene und wähle Help → Connect an agent. Wähle Claude Code, Codex oder deinen Desktop-Client und kopiere den Befehl oder die Konfiguration. Die App liefert die genauen Pfade für deine Installation, auch für Pro. Lass Phosphene geöffnet, solange der Agent arbeitet. Ändert ein späteres Update die Pfade, kopiere über dasselbe Menü eine neue Verbindung.

Pinokio: Starte Phosphene und öffne dann /agents/info unter der Studio-Adresse, die Pinokio anzeigt. Eine Standardinstallation nutzt http://127.0.0.1:8198/agents/info. Der Abschnitt agents darin liefert den Befehl und die Konfiguration. Diese Adresse gilt für Pinokio; die Mac-App nutzt stattdessen ihr Menü Help.

MCP-Werkzeuge: phosphene_status, phosphene_make_video, phosphene_make_image, phosphene_make_speech, phosphene_make_music, phosphene_list_jobs, phosphene_wait, phosphene_fetch, phosphene_stop. Renderings dauern Minuten: Ein Werkzeug make_* stellt in die Warteschlange und gibt eine Auftrags-ID zurück; phosphene_wait blockiert bis zu timeout_sec (Standard 1500 s) und kann erneut aufgerufen werden.

Die CLI

phosphene status
phosphene video "A night ferry crosses a dark harbour in light rain ..." --seconds 5 --out ./clips
phosphene video "..." --engine h3 --quality draft --seconds 10 --wait
phosphene video "..." --image still.png             # image to video (the picture is uploaded first)
phosphene image "a travel poster of a red tram" --n 2 --aspect 3:4 --out ./stills
phosphene jobs ; phosphene wait JOB --out DIR ; phosphene fetch JOB --out DIR ; phosphene stop
phosphene servers                                    # every studio answering on this Mac

--json bei jedem Befehl gibt maschinenlesbare Ausgabe. Exit-Codes: 0 ok, 1 das Studio hat abgelehnt oder der Auftrag ist fehlgeschlagen (sein Satz wird ausgegeben), 2 falsche Argumente, 3 Phosphene läuft nicht. (phosphene ist hier python3 agents/phosphene_cli.py; gib ihm einen Alias, wie du magst.)

Wie ein Werkzeug das Studio findet

Der Port des Studios hängt davon ab, wo es läuft: 8198 in Pinokio, 8199 für das Dev-Profil, ein freier Port in 8930-8999 in der Mac-App (PanelProcess.freePort), beliebig mit LTX_PORT. Also:

  1. PHOSPHENE_URL, wenn gesetzt, wird genutzt und sonst nichts.
  2. Jedes Studio schreibt ~/.phosphene/servers/<port>.json, sobald sein Listener gebunden ist, und entfernt es, wenn es stoppt (agent_discovery.py). Ein Eintrag gilt nur, wenn seine pid lebt und die URL auf GET /agents/info mit "app": "phosphene" antwortet. Der neueste zuerst. PHOSPHENE_DISCOVERY_DIR verschiebt den Ordner; PHOSPHENE_DISCOVERY=0 schaltet das Bekanntgeben ab.
  3. Ohne Eintrag (ein älteres Studio): 8198, 8199, dann 8930-8999.

Antwortet nichts: „Phosphene is not running on this Mac. Start it first: open the Phosphene app, or press Start on Phosphene in Pinokio.“ (CLI-Exit 3; bei MCP ein Werkzeugfehler, nie ein Absturz).

Free, Pro und Lizenzen

Die Werkzeuge fügen keine Route hinzu und entscheiden nichts. Jede Anfrage ist eine Anfrage, die auch die Seite selbst stellt (/queue/add, /speech/generate, /upload, /status, /file), also wendet das Studio dieselben Prüfungen an: was dieser Mac ausführen kann, Modelllizenzen (HTTP 451, bis die Person zustimmt) und was Free und Pro enthalten. Ein Formular kann kein Pro-Tempoprofil in einen Auftrag schleusen (make_job baut params aus einer Positivliste; test_agent_tools.py sichert das ab). Es gibt bewusst kein Werkzeug, das eine Modelllizenz annimmt: Für jemanden zuzustimmen heißt, an seiner Stelle zuzustimmen, also tut die Person das einmal in Phosphene.

GET /agents/info

{"app": "phosphene", "api": 1, "url": "http://127.0.0.1:8198", "port": 8198, "pid": 123,
 "version": "5.0.0", "distribution": "pinokio" | "mac-app", "edition": "free" | "pro", "profile": "production",
 "pro": {"active": false, ...},                       // GET /pro/status
 "engines": {"ltx": {"available": true, "qualities": [...]},
             "h3": {"available": false, "qualities": [...], "lengths": ["3s", "5s", "10s", "15s", ...]},
             "speech": {...}, "music": {...}, "image": {...}},
 "outputs_dir": "...",
 "agents": {"cli": "...", "mcp": "...", "python": "...", "mcp_config": {...}, "claude_code": "...", "codex": "..."}}

Günstig (kein Durchlaufen der Festplatte), sicher abzufragen. Tests: test_agent_tools.py.

Quelle: docs/AGENT_TOOLS.md im öffentlichen Repo. Für diese Website vor der Veröffentlichung geprüft. Aus dem englischen Original übersetzt. Änderung vorschlagen.