Repolode
lassejlv

lassejlv/pi-rs

pi 코딩 에이전트 하네스의 Rust 포트로, 동일한 CLI, 터미널 UI, 파일 형식과 확장 API를 제공하는 단일 네이티브 바이너리입니다.

스타
130
포크
15
열린 이슈
0
마지막 커밋
그저께

어떤 프로젝트인가요?

pi-rs는 최소한의 구성으로 확장 가능한 코딩 에이전트 pi를 Rust로 재구현한 프로젝트입니다. TypeScript 원본과 동일한 명령줄 인터페이스, 터미널 UI, 세션·설정·auth.json·models.json의 디스크 저장 형식, RPC 프로토콜, 확장 API를 목표로 하는 네이티브 `pi` 바이너리 하나를 빌드합니다. 런타임에 Node.js나 Bun은 필요하지 않습니다.

TypeScript 확장은 임베디드 JavaScript 엔진(Boa)에서 실행되며, oxc가 TypeScript 구문을 제거하고 fs, path, child_process 같은 Node 내장 모듈은 shim으로 제공합니다. 워크스페이스는 provider와 스트리밍(pi-ai), 에이전트 루프(pi-agent), 터미널 렌더러(pi-tui), MCP 클라이언트(pi-mcp), 샌드박스형 코드 모드(pi-codemode)를 담당하는 크레이트로 나뉘어 있습니다.

프로젝트 문서에는 TypeScript 버전과의 알려진 동작 차이가 정리되어 있습니다. 여기에는 서로 다른 JavaScript 엔진, Windows 터미널 백엔드 지원 누락, 일부 스택 트레이스 문구 차이가 포함됩니다.

핵심 기능

  • 01동일한 CLI와 대화형, print, JSON, RPC 모드를 제공하는 단일 네이티브 `pi` 바이너리입니다.
  • 02TypeScript 버전과 호환되는 세션, 설정, auth, models 파일을 읽고 씁니다.
  • 03Node.js 없이 임베디드 엔진에서 TypeScript 및 JavaScript 확장을 실행합니다.
  • 04Anthropic, OpenAI, Google, Bedrock, Mistral 등 다양한 LLM provider를 지원합니다.
  • 05stdio 및 streamable HTTP 전송 방식을 지원하는 MCP 클라이언트를 포함합니다.

활용 사례

  • Node.js나 Bun을 설치하기 어려운 머신에서 pi 코딩 에이전트를 실행합니다.
  • Rust 빌드와 TypeScript 빌드가 하나의 에이전트 설정 디렉터리를 공유합니다.
  • 네이티브 바이너리에서 실행해야 하는 pi 확장을 개발하거나 포팅합니다.
  • 터미널 기반 코딩 에이전트에서 MCP 서버를 사용합니다.

빠른 시작

  1. 1

    Rust 1.88 이상을 설치합니다

  2. 2

    릴리스 바이너리를 빌드합니다

    cargo build --release
  3. 3

    pi 바이너리를 ~/.cargo/bin에 설치합니다

    cargo install --path crates/pi-coding-agent
  4. 4

    설치된 버전을 확인합니다

    ./target/release/pi --version

사용 전 알아둘 점

  • 저장소 메타데이터에 라이선스가 명시되어 있지 않습니다.
  • JavaScript 엔진(Boa) 등을 포함해 TypeScript 버전의 pi와 동작이 다른 부분이 있으며, 이에 따라 확장 프로그램의 스택 트레이스와 오류 메시지가 달라집니다.
  • Windows 터미널 백엔드는 포팅되지 않았습니다.

포함된 컬렉션

토픽

자주 묻는 질문

pi-rs은(는) 무엇인가요?
pi 코딩 에이전트 하네스의 Rust 포트로, 동일한 CLI, 터미널 UI, 파일 형식과 확장 API를 제공하는 단일 네이티브 바이너리입니다. pi-rs는 최소한의 구성으로 확장 가능한 코딩 에이전트 pi를 Rust로 재구현한 프로젝트입니다. TypeScript 원본과 동일한 명령줄 인터페이스, 터미널 UI, 세션·설정·auth.json·models.json의 디스크 저장 형식, RPC 프로토콜, 확장 API를 목표로 하는 네이티브 `pi` 바이너리 하나를 빌드합니다. 런타임에 Node.js나 Bun은 필요하지 않습니다.
pi-rs은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
pi-rs에는 명시된 라이선스가 없습니다. 코드는 공개되어 있지만 라이선스가 없으면 재사용 허가가 명확하지 않으므로, 사용 전에 작성자에게 문의하는 것이 좋습니다.
pi-rs은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. pi-rs의 마지막 커밋은 2026년 11월 5일입니다.
pi-rs은(는) 어디에 사용할 수 있나요?
Node.js나 Bun을 설치하기 어려운 머신에서 pi 코딩 에이전트를 실행합니다. Rust 빌드와 TypeScript 빌드가 하나의 에이전트 설정 디렉터리를 공유합니다. 네이티브 바이너리에서 실행해야 하는 pi 확장을 개발하거나 포팅합니다. 터미널 기반 코딩 에이전트에서 MCP 서버를 사용합니다.
pi-rs는 어떻게 설치하나요?
Rust 1.88 이상을 설치합니다 릴리스 바이너리를 빌드합니다: cargo build --release pi 바이너리를 ~/.cargo/bin에 설치합니다: cargo install --path crates/pi-coding-agent 설치된 버전을 확인합니다: ./target/release/pi --version
pi-rs은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/lassejlv/pi-rs

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트