Livepeer Agent

Ein terminalorientierter Livepeer-Client mit einer deterministischen CLI und einem nativen Agenten.

Livepeer-Identität, Zugriff und E-Mail-Verifizierung werden von https://agent.livepeer.org/api/mcp verwaltet. Die CLI stellt einen einzigen Daydream-API-Schlüssel bereit und implementiert keinen separaten Produkt-Authentifizierungs- oder Berechtigungsdienst.

Install

Erfordert Node.js 22.19 oder neuer. Installieren Sie die neueste öffentliche Version ohne GitHub-Konto:

curl -fsSL https://raw.githubusercontent.com/peacenode/livepeer-agent-releases/main/install.sh | sh

Das Installationsprogramm überprüft die Prüfsumme der Version, installiert in ~/.local/share/livepeer-agent und verlinkt beide Befehle in ~/.local/bin. Falls dieses Verzeichnis noch nicht im PATH ist, fügen Sie es in Ihrem Shell-Profil hinzu.

Ab 0.1.1 können Sie im Terminal nach einem Update suchen oder die neueste Version installieren:

livepeer update --check
livepeer update

Benutzer von 0.1.0 können aktualisieren, indem sie den Einzeiler-Installer einmal erneut ausführen; spätere Versionen unterstützen direkt livepeer update.

Die Quellentwicklung findet in diesem Repository statt. Stabile Release-Artefakte, das Installationsprogramm und Hinweise zu Drittanbietern werden auf peacenode/livepeer-agent-releases gespiegelt. Die SHA-256-Überprüfung erkennt eine beschädigte oder nicht übereinstimmende heruntergeladene Datei; da die Prüfsumme neben dem Archiv gehostet wird, schützt sie nicht unabhängig vor einer Kompromittierung des Distributions-Repositorys oder seiner Betreuer.

Fixieren Sie eine Version oder wählen Sie andere benutzereigene Verzeichnisse mit Umgebungsvariablen:

LIVEPEER_AGENT_VERSION=v0.1.0 \
LIVEPEER_AGENT_INSTALL_ROOT="$HOME/.livepeer-agent" \
LIVEPEER_AGENT_BIN_DIR="$HOME/bin" \
sh install.sh

Quellversionen werden ohne npm erstellt, indem ein v*-Tag gepusht oder der Release-Workflow mit einer Version wie v0.1.0 ausgeführt wird. Der Workflow durchläuft das vollständige Qualitätsgate, bevor livepeer-agent.tgz und seine SHA-256-Prüfsumme hochgeladen werden. Ein Betreuer kann dann diese exakt verifizierten Dateien mit ./scripts/promote-release.sh v0.1.0 in das stabile Distributions-Repository spiegeln.

Related MCP server: MAGI Orchestrator

Development

Erfordert Node.js 22.19 oder neuer und pnpm 10.

pnpm install
pnpm lint
pnpm typecheck
pnpm test
pnpm build
pnpm package:validate

Von der Testsuite wird kein echter Dienst kontaktiert.

Lokale Umgebungsüberschreibungen gehören in die ignorierte Datei .env.local, niemals in .env.example. Die CLI lädt sie nicht automatisch; laden Sie sie nur für den Befehl, der die Werte benötigt:

set -a
. ./.env.local
set +a
livepeer agent

Bevorzugen Sie livepeer key add für einen Daydream-Schlüssel, da es den Plattform-Anmeldeinformationsspeicher anstelle einer Klartext-Projektdatei verwendet.

CLI

Erstellen und validieren Sie ein eigenständiges installierbares Paket:

pnpm build
pnpm package:validate

Der Validator packt die CLI, installiert sie in ein temporäres globales Präfix und ruft sowohl livepeer --help als auch livepeer-agent --help auf.

Speichern Sie einen Daydream-Schlüssel über die versteckte Eingabeaufforderung:

livepeer key add
livepeer key status

Für temporäre lokale Tests stellen Sie den Schlüssel über die Prozessumgebung bereit. Vermeiden Sie es, den Wert direkt in einen export DAYDREAM_API_KEY=...-Befehl zu schreiben, da Shells diesen Befehl üblicherweise im Verlauf behalten:

read -s DAYDREAM_API_KEY
export DAYDREAM_API_KEY
livepeer agent
unset DAYDREAM_API_KEY

Der Schlüssel wird nur an den festgelegten Livepeer-MCP-Endpunkt gesendet. Ein gespeicherter Schlüssel hat Vorrang vor DAYDREAM_API_KEY; die CLI schlägt fehl, anstatt einen der Schlüssel weiterzuleiten, wenn LIVEPEER_MCP_URL diesen Endpunkt überschreibt. Die CLI lädt keine .env-Dateien automatisch.

Die E-Mail-Verifizierung gehört zum MCP-Profil des aktuellen Schlüssels. Bitten Sie im Agenten, Ihre E-Mail zu verifizieren; er wird me_update, request_activation und dann activate aufrufen, nachdem Sie den Einmalcode bereitgestellt haben. Die Verifizierung eines nicht zugehörigen Website-Kontos oder eines anderen API-Schlüssels aktiviert nicht den aktuellen Schlüssel.

Access paths

Livepeer Agent unterstützt zwei explizite MCP-eigene Pfade:

1. Schlüssellose Vorschau: Führen Sie livepeer aus und sagen Sie dann verify my email. MCP hängt den E-Mail-Fluss an das aktuelle schlüssellose Profil an und schaltet nur das Vorschaukontingent frei.

2. Daydream-Modelle: Führen Sie livepeer key add aus, starten Sie einen bereits geöffneten Agenten neu und führen Sie dann livepeer access status aus. Ein erfolgreicher Status meldet credentialApplied: true und keyClass: "daydream". Sagen Sie im Agenten verify my email, wenn MCP für eine gesperrte Aktion ein E-Mail-Profil benötigt.

livepeer access status meldet nur sichere Boolesche Werte und Zustandsbezeichnungen; es gibt niemals den API-Schlüssel, die E-Mail-Adresse oder die Principal-ID aus. Das Hinzufügen und Verifizieren eines schlüssellosen Profils schaltet keine Daydream-Modelle frei, und das Hinzufügen eines Daydream-Schlüssels überträgt kein Profil, das zuvor unter einem anderen MCP-Principal verifiziert wurde.

Häufige Befehle:

livepeer tools list
livepeer key add
livepeer key status
livepeer access status
livepeer capabilities list --kind ai --limit 10
livepeer tools call <name> --input request.json --yes
livepeer media generate --prompt "A quiet field at sunrise" --yes
livepeer jobs wait <job-id> --interval 2 --timeout 600
livepeer provider add openai
livepeer provider login openai-codex
livepeer browser install
livepeer agent

Browser automation

Der Agent verwendet native, zustandsbehaftete Browser-Tools anstatt curl aufzurufen oder rohes HTML zu scrapen. Die Tools werden von einem festgelegten Playwright-CLI-Begleiter unterstützt und arbeiten mit Barrierefreiheits-Snapshots und Element-Referenzen. Installieren Sie den Begleiter und den verwalteten Chromium-Build einmal:

livepeer browser status
livepeer browser install

Die eigenständige CLI bleibt klein und lädt während der normalen Paketinstallation niemals Chromium herunter. Verwaltete Browserdateien befinden sich unterhalb des Livepeer-Konfigurationsverzeichnisses. Schreibgeschützte Navigation erfolgt automatisch; Interaktionen, die Daten senden oder eine Website ändern könnten, erfordern eine Terminalbestätigung. Verwenden Sie einen Browser mit grafischer Oberfläche für Login, SSO oder 2FA und geben Sie Anmeldeinformationen direkt im Browserfenster ein.

Modellanbieter-Schlüssel werden in der macOS-Schlüsselverwaltung als separate OpenAI- und Anthropic-Einträge gespeichert. Auf Systemen ohne unterstützten Anmeldeinformationsspeicher warnt die CLI, bevor sie anbieterspezifische Dateien mit Berechtigung 0600 verwendet. Vorhandene providers.json-Schlüssel werden einzeln migriert und nach einem erfolgreichen sicheren Schreibvorgang aus der Legacy-Datei entfernt.

livepeer provider login openai-codex verwendet den integrierten ChatGPT/Codex-OAuth-Fluss von Pi. Die OAuth-Anmeldeinformationen und der Aktualisierungsstatus verbleiben auf dem Computer des Benutzers in der Schlüsselverwaltung und gelangen niemals in Livepeer-Zugriff, Transkripte oder Modellkontext. Der direkte Zugriff auf den OpenAI-API-Schlüssel bleibt über livepeer provider add openai verfügbar.

Contributing and security

Siehe CONTRIBUTING.md für Entwicklungs- und Verifizierungsanforderungen. Melden Sie Sicherheitslücken vertraulich gemäß den Anweisungen in SECURITY.md; eröffnen Sie kein öffentliches Issue für eine vermutete Sicherheitslücke oder offengelegte Anmeldeinformationen.

Livepeer Agent ist unter der Apache License 2.0 lizenziert. Der eigene Pi-Coding-Agent-Fork behält seine ursprüngliche MIT-Lizenz; die Zuordnung gebündelter Abhängigkeiten ist in THIRD_PARTY_NOTICES.md festgehalten.