Pi-Agent SDK를 다루는 이중 언어 튜토리얼과 소스 코드 해설, 예제 코드 및 에이전트 구축용 AI 어시스턴트 스킬
hahhforest/pi-textbook
TypeScript로 실행 가능한 Git 체크포인트 15개를 따라 Pi 스타일 코딩 에이전트를 만드는 중국어 교재입니다.
- 스타
- 1,407
- 포크
- 83
- 열린 이슈
- 1
- 마지막 커밋
- 3개월 전
어떤 프로젝트인가요?
TypeScript로 Pi 스타일 코딩 에이전트를 처음부터 만드는 과정입니다. 오프라인 에이전트 궤적에서 시작해 체크포인트마다 메시지 및 모델 프로토콜, 스트리밍, provider 어댑터, 도구, 에이전트 루프, 세션 트리, 컨텍스트 압축, 확장 기능, 독립형 평가 하네스를 한 단계씩 추가합니다.
각 장에는 교재 본문, 동반 강의 저장소의 실제 커밋, 집중 테스트, 오류 주입 실험이 포함됩니다. 강의 코드는 각 단계에서 체크아웃하고 실행해 검증할 수 있는 Git 이력으로 제공되며, 의사 코드가 아닙니다. 온라인 책으로도, npm으로 실행하는 로컬 개발 서버로도 이용할 수 있습니다.
이 강의는 비공식 커뮤니티 제작 자료입니다. 코드는 MIT, 교재 콘텐츠는 CC BY 4.0 라이선스로 제공되며, 학습 에이전트와 함께 사용할 체크포인트와 실습 디렉터리를 설정하는 도우미 CLI도 포함되어 있습니다.
핵심 기능
- 01체크포인트 15개가 제공되며, 각각 체크아웃하고 실행할 수 있는 실제 커밋입니다.
- 02메시지 타입과 스트리밍부터 provider 어댑터, 도구, 에이전트 루프까지 전체 과정을 다룹니다.
- 03긴 대화를 위한 세션 트리 영속성과 컨텍스트 압축을 포함합니다.
- 04완성된 에이전트를 위한 확장 시스템과 독립형 평가로 마무리합니다.
- 05체크포인트로 이동하거나 정답이 포함되지 않은 실습 디렉터리를 생성하는 CLI를 제공합니다.
활용 사례
- 직접 코딩 에이전트를 만들어 보며 내부 동작을 학습할 때.
- 실제 프로젝트를 통해 판별 유니온, 이벤트 스트림, 런타임 검증 같은 TypeScript 패턴을 익힐 때.
- AI 튜터 에이전트와 함께 체크포인트를 단계별 실습 과정으로 활용할 때.
빠른 시작
- 1
교재 저장소를 클론합니다
git clone https://github.com/hahhforest/pi-textbook.git - 2
프로젝트 디렉터리로 이동합니다
cd pi-textbook - 3
종속성을 설치합니다
npm install - 4
로컬 개발 서버를 시작합니다
npm run dev
사용 전 알아둘 점
- 교재는 중국어로 작성되어 있어 영어 사용자에게는 주요 내용을 이해하기 어려울 수 있습니다.
- 강의 코드는 별도의 fork 브랜치에 있으므로 체크포인트를 실행하려면 해당 브랜치를 클론해야 합니다.
토픽
자주 묻는 질문
- pi-textbook은(는) 무엇인가요?
- TypeScript로 실행 가능한 Git 체크포인트 15개를 따라 Pi 스타일 코딩 에이전트를 만드는 중국어 교재입니다. TypeScript로 Pi 스타일 코딩 에이전트를 처음부터 만드는 과정입니다. 오프라인 에이전트 궤적에서 시작해 체크포인트마다 메시지 및 모델 프로토콜, 스트리밍, provider 어댑터, 도구, 에이전트 루프, 세션 트리, 컨텍스트 압축, 확장 기능, 독립형 평가 하네스를 한 단계씩 추가합니다.
- pi-textbook은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- pi-textbook은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- pi-textbook은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. pi-textbook의 마지막 커밋은 2026년 7월 23일입니다.
- pi-textbook은(는) 어디에 사용할 수 있나요?
- 직접 코딩 에이전트를 만들어 보며 내부 동작을 학습할 때. 실제 프로젝트를 통해 판별 유니온, 이벤트 스트림, 런타임 검증 같은 TypeScript 패턴을 익힐 때. AI 튜터 에이전트와 함께 체크포인트를 단계별 실습 과정으로 활용할 때.
- pi-textbook는 어떻게 설치하나요?
- 교재 저장소를 클론합니다: git clone https://github.com/hahhforest/pi-textbook.git 프로젝트 디렉터리로 이동합니다: cd pi-textbook 종속성을 설치합니다: npm install 로컬 개발 서버를 시작합니다: npm run dev
- pi-textbook은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/hahhforest/pi-textbook
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Claude API를 기반으로 파일, 셸, 검색 도구를 하나씩 추가하며 코딩 에이전트를 만드는 과정을 알려주는 단계별 Go 워크숍입니다.
Pi Coding Agent 터미널 하네스의 설치부터 Skills, Extensions, Subagents, 장기 실행 워크플로까지 다루는 비공식 중국어 가이드입니다.
IDE 확장, 터미널 CLI, 데스크톱 앱 또는 SDK로 실행되는 오픈소스 자율 코딩 에이전트입니다.
LSP, 디버거, 브라우저, 서브에이전트 도구를 내장하고 60개 이상의 모델 제공자를 지원하는 터미널 코딩 에이전트입니다.