Livepeer Agent

Livepeer-клиент с приоритетом терминала, детерминированным CLI и нативным агентом.

Идентификация Livepeer, доступ и проверка электронной почты находятся в ведении https://agent.livepeer.org/api/mcp. CLI работает с одним ключом API Daydream и не реализует отдельного сервиса аутентификации продукта или выдачи прав.

Install

Требуется 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, добавьте его в профиль вашей оболочки.

Начиная с 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

Исходные релизы собираются без npm: для этого создайте тег v* или запустите рабочий процесс Release с версией, например v0.1.0. Рабочий процесс выполняет полный контроль качества перед загрузкой 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 не загружает его автоматически; подключайте его через source только для команды, которой нужны значения:

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

Для ключа Daydream предпочитайте livepeer key add, так как он использует хранилище учетных данных платформы вместо файла проекта в открытом виде.

CLI

Соберите и проверьте автономный устанавливаемый пакет:

pnpm build
pnpm package:validate

Проверщик упаковывает CLI, устанавливает его во временный глобальный префикс и вызывает обе команды: livepeer --help и livepeer-agent --help.

Сохраните ключ Daydream через скрытый запрос:

livepeer key add
livepeer key status

Для временного локального тестирования передайте ключ через окружение процесса. Не записывайте значение напрямую в команду export DAYDREAM_API_KEY=...: оболочки часто сохраняют эту команду в истории:

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 текущего ключа. В агенте попросите проверить вашу электронную почту; он вызовет me_update, request_activation, а затем activate после того, как вы предоставите одноразовый код. Проверка учетной записи на постороннем сайте или с другим ключом API не активирует текущий ключ.

Пути доступа

Livepeer Agent поддерживает два явных пути, управляемых MCP:

1. Бесключевой предварительный просмотр: запустите livepeer, затем скажите verify my email. MCP привязывает процедуру проверки электронной почты к текущему бесключевому профилю и разблокирует только предварительную квоту.

2. Модели Daydream: выполните livepeer key add, перезапустите любой уже открытый агент, затем выполните livepeer access status. Успешный статус выводит значения credentialApplied: true и keyClass: "daydream". В агенте скажите verify my email, если MCP требует профиль электронной почты для действия, требующего прав доступа.

livepeer access status выводит только безопасные логические значения и метки состояния; он никогда не печатает ключ API, адрес электронной почты или идентификатор субъекта. Добавление и проверка бесключевого профиля не разблокируют модели 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

Автоматизация браузера

Агент использует нативные браузерные инструменты с сохранением состояния, а не вызывает curl из оболочки и не извлекает данные из необработанного HTML. Инструменты основаны на закрепленном вспомогательном CLI Playwright и работают со снимками доступности, содержащими ссылки на элементы. Установите вспомогательный компонент и управляемую сборку Chromium один раз:

livepeer browser status
livepeer browser install

Автономный CLI остается небольшим и никогда не загружает Chromium при обычной установке пакета. Управляемые файлы браузера находятся внутри каталога конфигурации Livepeer. Навигация только для чтения выполняется автоматически; действия, которые могут отправлять данные или изменять веб-сайт, требуют подтверждения в терминале. Для входа, SSO или 2FA используйте браузер с графическим интерфейсом и вводите учетные данные прямо в окне браузера.

Ключи поставщиков моделей хранятся в macOS Keychain как отдельные записи OpenAI и Anthropic. В системах без поддерживаемого хранилища учетных данных CLI предупреждает перед использованием файлов конкретного поставщика с правами доступа 0600. Существующие ключи из providers.json переносятся по отдельности и удаляются из устаревшего файла после успешной безопасной записи.

livepeer provider login openai-codex использует встроенный поток OAuth ChatGPT/Codex от Pi. Учетные данные OAuth и состояние обновления токена остаются на компьютере пользователя в Keychain и никогда не попадают в доступ Livepeer, транскрипты или контекст модели. Прямой доступ к ключу API OpenAI по-прежнему доступен через livepeer provider add openai.

Участие и безопасность

Требования к разработке и проверке см. в CONTRIBUTING.md. Сообщайте об уязвимостях безопасности конфиденциально, следуя инструкциям в SECURITY.md; не открывайте публичный issue при подозрении на уязвимость или раскрытие учетных данных.

Livepeer Agent распространяется под лицензией Apache License 2.0. Собственный форк Pi coding-agent сохраняет исходную лицензию MIT; сведения об атрибуции включенных зависимостей записаны в THIRD_PARTY_NOTICES.md.