Livepeer Agent

一款以终端为先的 Livepeer 客户端，配备确定性 CLI 和原生 Agent。

Livepeer 身份、访问和邮件验证由 https://agent.livepeer.org/api/mcp 拥有。CLI 提供一个 Daydream API 密钥，不实现单独的产品认证或授权服务。

安装

需要 Node.js 22.19 或更高版本。无需 GitHub 账户即可安装最新的公开发布版本：

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

安装程序会验证发行版校验和，将文件安装到 ~/.local/share/livepeer-agent，并将两个命令链接到 ~/.local/bin。如果该目录尚未加入 PATH，请在 shell 配置文件中添加。

从 0.1.1 版本开始，可在终端中检查更新或安装最新版本：

livepeer update --check
livepeer update

0.1.0 版本的用户可以重新运行单行安装程序进行一次更新；后续版本支持直接使用 livepeer update 命令。

源代码开发在此仓库中进行。稳定发行版工件、安装程序和第三方声明已镜像至 peacenode/livepeer-agent-releases。SHA-256 校验可检测损坏或不匹配的下载；但由于校验和与压缩包放在同一位置，它不能独立防范发行版仓库或其维护者被攻破的风险。

使用环境变量固定特定版本或选择不同的用户自有目录：

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

源代码发行版通过推送 v* 标签或运行 Release 工作流（使用 v0.1.0 等版本号）来构建，无需 npm。工作流在上传 livepeer-agent.tgz 及其 SHA-256 校验和之前会运行完整的质量检查。维护者随后可以通过 ./scripts/promote-release.sh v0.1.0 将这些经过验证的确切文件镜像到稳定发行版仓库。

Related MCP server: MAGI Orchestrator

开发

需要 Node.js 22.19 或更高版本以及 pnpm 10。

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

测试套件不会连接任何真实服务。

本地环境覆盖应放在被忽略的 .env.local 文件中，切勿放在 .env.example 中。CLI 不会自动加载该文件；仅在需要相关值的命令中引用它：

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

推荐使用 livepeer key add 来添加 Daydream 密钥，因为它使用平台凭据存储而非明文的项目文件。

CLI

构建并验证一个独立的可安装包：

pnpm build
pnpm package:validate

验证程序会将 CLI 打包，安装到临时全局前缀，然后调用 livepeer --help 和 livepeer-agent --help。

通过隐藏提示存储 Daydream 密钥：

livepeer key add
livepeer key status

对于临时本地测试，可通过进程环境提供密钥。避免直接在 export DAYDREAM_API_KEY=... 命令中写入值，因为 shell 通常会将该命令保留在历史记录中：

read -s DAYDREAM_API_KEY
export DAYDREAM_API_KEY
livepeer agent
unset DAYDREAM_API_KEY

该密钥仅发送到固定的 Livepeer MCP 端点。已存储的密钥优先于 DAYDREAM_API_KEY；当 LIVEPEER_MCP_URL 覆盖该端点时，CLI 会安全关闭而不会转发任一密钥。CLI 不会自动加载 .env 文件。

邮件验证属于当前密钥的 MCP 配置文件。在 Agent 中，请求验证您的邮件；它会依次调用 me_update、request_activation，然后在您提供一次性验证码后调用 activate。验证无关的网站账户或不同的 API 密钥不会激活当前密钥。

访问路径

Livepeer Agent 支持两个明确的 MCP 自有路径：

1. 无密钥预览： 运行 livepeer，然后输入 verify my email。MCP 将邮件流程关联到当前的无密钥配置文件，仅解锁预览权限。

2. Daydream 模型： 运行 livepeer key add，重启已打开的 Agent，然后运行 livepeer access status。成功状态会报告 credentialApplied: true 和 keyClass: "daydream"。在 Agent 中，如果 MCP 因受限操作需要邮件配置文件，请输入 verify my email。

livepeer access status 仅报告安全的布尔值和状态标签；它永远不会打印 API 密钥、电子邮件地址或主体 ID。添加和验证无密钥配置文件不会解锁 Daydream 模型，添加 Daydream 密钥也不会转移已在其他 MCP 主体下验证的配置文件。

常用命令：

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

浏览器自动化

Agent 使用原生、有状态的浏览器工具，而不是通过 curl 或抓取原始 HTML。这些工具由固定的 Playwright CLI 伴侣支持，并基于带有元素引用的无障碍快照进行操作。一次性安装伴侣及托管的 Chromium 构建：

livepeer browser status
livepeer browser install

独立的 CLI 保持小巧，在普通软件包安装过程中绝不会下载 Chromium。托管的浏览器文件位于 Livepeer 配置目录下。只读导航是自动的；可能提交数据或更改网站内容的交互需要终端批准。对于登录、SSO 或 2FA，请使用有头浏览器并直接在浏览器窗口中输入凭据。

模型提供者密钥作为单独的 OpenAI 和 Anthropic 条目存储在 macOS 钥匙串中。在不支持凭据存储的系统上，CLI 会在使用特定提供者的权限 0600 文件之前发出警告。现有的 providers.json 密钥会逐个迁移，并在成功安全写入后从旧文件中移除。

livepeer provider login openai-codex 使用 Pi 内置的 ChatGPT/Codex OAuth 流程。OAuth 凭据和刷新状态保留在用户计算机的钥匙串中，永远不会进入 Livepeer 访问记录、转录或模型上下文。通过 livepeer provider add openai 仍可使用直接的 OpenAI API 密钥访问。

贡献与安全

有关开发和验证要求，请参阅 CONTRIBUTING.md。使用 SECURITY.md 中的说明私下报告安全漏洞；对于可疑漏洞或泄露的凭据，请勿创建公开 issue。

Livepeer Agent 根据 Apache License 2.0 许可。其拥有的 Pi 编码 Agent 分支保留上游 MIT 许可；捆绑依赖的归属记录在 THIRD_PARTY_NOTICES.md 中。