SaladDay/pi-from-scratch

어떤 프로젝트인가요?

핵심 기능

• 01파일 읽기, 코드 편집, 셸 명령 실행이 가능한 코딩 에이전트를 만듭니다.
• 02pi의 데이터 흐름을 따르되 핵심 설계 아이디어만 남깁니다.
• 03글과 소스 코드를 함께 제공하며, 에디터에서 코드가 단계별로 채워집니다.
• 04중단점을 설정하고 코드 실행 과정을 따라갈 수 있는 trace 뷰어를 제공합니다.
• 05환경 변수를 통해 OpenAI 호환 API를 사용할 수 있습니다.

활용 사례

• 코딩 에이전트의 루프, 도구 호출, 파일 편집이 내부적으로 어떻게 작동하는지 학습합니다.
• pi를 깊이 있게 공부하기 전에 직접 만든 소형 에이전트의 기반을 마련합니다.
• 워크숍이나 강의에서 에이전트 아키텍처를 가르칩니다.

빠른 시작

1. 1

   Node.js 22 이상을 설치하고 OpenAI 호환 API 키를 발급받으세요

2. 2

   종속성을 설치하세요

   npm install
3. 3

   API 키를 설정하세요

   export NANOPI_API_KEY=your-api-key
4. 4

   프로젝트를 시작하세요

   npm run dev

사용 전 알아둘 점

• !에이전트를 실행하려면 OpenAI 호환 API 키가 필요합니다.

Repolode 주간에 소개됨

• 제 2호 · 에이전트용 Rust 헤드리스 브라우저와 타입이 붙는 SQL 임포트

  파일 읽기, 코드 수정, 명령 실행이 가능한 최소한의 코딩 에이전트를 TypeScript로 처음부터 만드는 튜토리얼입니다. pi의 데이터 흐름을 따라 핵심 설계만 남겼고, 글 옆의 소스 코드가 단계별로 채워집니다.

포함된 컬렉션

토픽

자주 묻는 질문

pi-from-scratch은(는) 무엇인가요?

파일 읽기, 코드 편집, 명령 실행이 가능한 최소한의 TypeScript 코딩 에이전트를 처음부터 만드는 단계별 튜토리얼입니다. PI from Scratch는 약 600줄의 TypeScript로 pi 코딩 에이전트의 핵심 아이디어를 재현하는 실습형 튜토리얼입니다. 이 구현은 nano-pi라고 불립니다. pi의 데이터 흐름을 따라가며, 각 구성 요소를 이해하는 데 필요한 수준까지만 구현하고 프로덕션 엔지니어링의 세부 사항은 제외합니다.

pi-from-scratch은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

pi-from-scratch은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

pi-from-scratch은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. pi-from-scratch의 마지막 커밋은 2026년 10월 24일입니다.

pi-from-scratch은(는) 어디에 사용할 수 있나요?

코딩 에이전트의 루프, 도구 호출, 파일 편집이 내부적으로 어떻게 작동하는지 학습합니다. pi를 깊이 있게 공부하기 전에 직접 만든 소형 에이전트의 기반을 마련합니다. 워크숍이나 강의에서 에이전트 아키텍처를 가르칩니다.

pi-from-scratch는 어떻게 설치하나요?

Node.js 22 이상을 설치하고 OpenAI 호환 API 키를 발급받으세요 종속성을 설치하세요: npm install API 키를 설정하세요: export NANOPI_API_KEY=your-api-key 프로젝트를 시작하세요: npm run dev

pi-from-scratch은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/SaladDay/pi-from-scratch