Livepeer Agent

터미널 우선의 Livepeer 클라이언트로, 결정론적 CLI와 네이티브 에이전트를 갖추고 있습니다.

Livepeer의 ID, 접근 권한, 이메일 인증은 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에 없으면 셸 프로필에 추가하세요.

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* 태그를 푸시하거나 v0.1.0과 같은 버전으로 Release 워크플로우를 실행하여 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

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"을 보고합니다. 에이전트에서 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

브라우저 자동화

에이전트는 curl로 셸 아웃하거나 원시 HTML을 스크래핑하는 대신 네이티브 상태 저장 브라우저 도구를 사용합니다. 이 도구는 고정된 Playwright CLI 컴패니언에 의해 지원되며 요소 참조가 있는 접근성 스냅샷에서 작동합니다. 컴패니언과 관리형 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는 Pi에 내장된 ChatGPT/Codex OAuth 흐름을 사용합니다. OAuth 자격 증명과 갱신 상태는 사용자 컴퓨터의 Keychain에 남아 있으며 Livepeer 접근, 기록 또는 모델 컨텍스트에 절대 입력되지 않습니다. livepeer provider add openai를 통해 직접 OpenAI API 키 접근이 계속 가능합니다.

기여 및 보안

개발 및 검증 요구 사항은 CONTRIBUTING.md를 참조하세요. 보안 취약점은 SECURITY.md의 지침을 사용하여 비공개로 신고하세요. 의심되는 취약점이나 노출된 자격 증명에 대해 공개 이슈를 열지 마세요.

Livepeer Agent는 Apache License 2.0에 따라 라이선스가 부여됩니다. 소유한 Pi 코딩 에이전트 포크는 상위 MIT 라이선스를 유지합니다. 번들 종속성 귀속은 THIRD_PARTY_NOTICES.md에 기록되어 있습니다.