Livepeer Agent

Un cliente de Livepeer orientado a terminal con una CLI determinista y un agente nativo.

La identidad, el acceso y la verificación de correo electrónico de Livepeer son propiedad de https://agent.livepeer.org/api/mcp. La CLI proporciona una única clave de Daydream API y no implementa un servicio independiente de autenticación de producto o autorización.

Instalación

Requiere Node.js 22.19 o superior. Instala la última versión pública sin necesidad de una cuenta de GitHub:

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

El instalador verifica la suma de comprobación de la versión, instala en ~/.local/share/livepeer-agent y enlaza ambos comandos en ~/.local/bin. Si ese directorio no está ya en PATH, agrégalo en el perfil de tu shell.

A partir de 0.1.1, comprueba si hay una actualización o instala la última versión desde la terminal:

livepeer update --check
livepeer update

Los usuarios de 0.1.0 pueden actualizar volviendo a ejecutar el instalador de una línea una vez; las versiones posteriores admiten livepeer update directamente.

El desarrollo del código fuente ocurre en este repositorio. Los artefactos de versiones estables, el instalador y los avisos de terceros se reflejan en peacenode/livepeer-agent-releases. La verificación SHA-256 detecta una descarga corrupta o no coincidente; debido a que la suma de comprobación está alojada junto al archivo, no protege de forma independiente contra el compromiso del repositorio de distribución o de sus mantenedores.

Fija una versión o elige directorios de propiedad del usuario diferentes con variables de entorno:

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

Las versiones de código fuente se construyen sin npm al enviar una etiqueta v* o ejecutar el flujo de trabajo Release con una versión como v0.1.0. El flujo de trabajo ejecuta la compuerta de calidad completa antes de subir livepeer-agent.tgz y su suma de comprobación SHA-256. Un mantenedor puede entonces reflejar esos archivos exactos verificados en el repositorio de distribución estable con ./scripts/promote-release.sh v0.1.0.

Related MCP server: MAGI Orchestrator

Desarrollo

Requiere Node.js 22.19 o superior y pnpm 10.

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

El conjunto de pruebas no contacta con ningún servicio real.

Las sobrescrituras del entorno local pertenecen al archivo ignorado .env.local, nunca en .env.example. La CLI no lo carga automáticamente; actívalo solo para el comando que necesite los valores:

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

Prefiere livepeer key add para una clave de Daydream porque usa el almacén de credenciales de la plataforma en lugar de un archivo de proyecto en texto plano.

CLI

Construye y valida un paquete instalable independiente:

pnpm build
pnpm package:validate

El validador empaqueta la CLI, la instala en un prefijo global temporal e invoca tanto livepeer --help como livepeer-agent --help.

Almacena una clave de Daydream a través del mensaje oculto:

livepeer key add
livepeer key status

Para pruebas locales temporales, proporciona la clave a través del entorno del proceso. Evita escribir el valor directamente en un comando export DAYDREAM_API_KEY=... porque los shells suelen retener ese comando en el historial:

read -s DAYDREAM_API_KEY
export DAYDREAM_API_KEY
livepeer agent
unset DAYDREAM_API_KEY

La clave se envía solo al endpoint MCP de Livepeer fijado. Una clave almacenada tiene prioridad sobre DAYDREAM_API_KEY; la CLI falla de forma segura en lugar de reenviar cualquiera de las claves cuando LIVEPEER_MCP_URL sobrescribe ese endpoint. La CLI no carga automáticamente archivos .env.

La verificación de correo electrónico pertenece al perfil MCP de la clave actual. En el agente, pide verificar tu correo electrónico; llamará a me_update, request_activation y luego activate después de que proporciones el código de un solo uso. Verificar una cuenta de sitio web no relacionada o una clave API diferente no activa la clave actual.

Rutas de acceso

Livepeer Agent admite dos rutas explícitas propiedad de MCP:

1. Vista previa sin clave: ejecuta livepeer, luego di verify my email. MCP asocia el flujo de correo electrónico al perfil actual sin clave y desbloquea solo la asignación de vista previa.

2. Modelos Daydream: ejecuta livepeer key add, reinicia cualquier agente ya abierto, luego ejecuta livepeer access status. Un estado exitoso informa credentialApplied: true y keyClass: "daydream". En el agente, di verify my email si MCP requiere un perfil de correo electrónico para una acción restringida.

livepeer access status informa solo valores booleanos seguros y etiquetas de estado; nunca imprime la clave API, la dirección de correo electrónico ni el ID de principal. Agregar y verificar un perfil sin clave no desbloquea los modelos Daydream, y agregar una clave Daydream no transfiere un perfil previamente verificado bajo otro principal MCP.

Comandos comunes:

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

Automatización del navegador

El agente utiliza herramientas nativas de navegador con estado en lugar de recurrir a curl o raspar HTML sin procesar. Las herramientas están respaldadas por un compañero CLI de Playwright fijado y operan sobre instantáneas de accesibilidad con referencias a elementos. Instala el compañero y la compilación administrada de Chromium una vez:

livepeer browser status
livepeer browser install

La CLI independiente se mantiene pequeña y nunca descarga Chromium durante la instalación normal del paquete. Los archivos del navegador administrado residen debajo del directorio de configuración de Livepeer. La navegación de solo lectura es automática; las interacciones que puedan enviar datos o cambiar un sitio web requieren aprobación desde la terminal. Usa un navegador con interfaz gráfica para inicio de sesión, SSO o 2FA e ingresa las credenciales directamente en la ventana del navegador.

Las claves del proveedor de modelos se almacenan en el Llavero de macOS como entradas separadas de OpenAI y Anthropic. En sistemas sin almacenamiento de credenciales compatible, la CLI advierte antes de usar archivos específicos del proveedor con permiso 0600. Las claves existentes de providers.json se migran individualmente y se eliminan del archivo heredado después de una escritura segura exitosa.

livepeer provider login openai-codex utiliza el flujo OAuth integrado de ChatGPT/Codex de Pi. La credencial OAuth y el estado de actualización permanecen en el ordenador del usuario en el Llavero y nunca ingresan al acceso de Livepeer, transcripciones o contexto del modelo. El acceso directo a la clave API de OpenAI sigue estando disponible a través de livepeer provider add openai.

Contribuir y seguridad

Consulta CONTRIBUTING.md para conocer los requisitos de desarrollo y verificación. Reporta vulnerabilidades de seguridad de forma privada usando las instrucciones en SECURITY.md; no abras un issue público para una vulnerabilidad sospechada o una credencial expuesta.

Livepeer Agent está licenciado bajo la Apache License 2.0. El fork propio del agente de codificación Pi conserva su licencia MIT original; la atribución de dependencias empaquetadas se registra en THIRD_PARTY_NOTICES.md.