deeplethe/forkd

어떤 프로젝트인가요?

핵심 기능

• 01워밍업된 부모 스냅샷에서 copy-on-write 메모리 공유 방식으로 자식 마이크로VM을 생성합니다.
• 02각 자식을 별도의 네트워크 네임스페이스를 갖춘 KVM 기반 Firecracker 프로세스로 실행합니다.
• 03라이브 샌드박스를 스냅샷으로 저장하고 재개하는 BRANCH를 지원하며, 일시 중지 시간을 줄이는 라이브 모드도 제공합니다.
• 04diff 스냅샷을 체인으로 연결하고 이식 가능한 아카이브로 묶거나 압축을 풉니다.
• 05REST API, CLI, Python 및 TypeScript SDK, MCP 서버를 제공합니다.
• 06Prometheus 메트릭과 추가만 가능한 JSON 감사 로그를 제공합니다.

활용 사례

• 요청마다 라이브러리가 미리 로드된 새 샌드박스를 제공하는 코드 인터프리터 세션 실행.
• 에이전트 평가를 위해 수백 개의 저장소 체크아웃이나 테스트 롤아웃을 병렬로 실행.
• KVM 격리를 적용한 자체 호스팅 Linux 호스트에서 사용자별 코드 실행 환경 제공.
• 실행 중인 에이전트의 샌드박스 상태를 분기해 다음 단계의 여러 대안을 시도.

빠른 시작

1. 1

   README의 설치 섹션에 따라 forkd를 설치합니다

2. 2

   스냅샷 태그에서 샌드박스 3개를 포크합니다

   forkd fork --tag py-pandas -n 1

사용 전 알아둘 점

• !KVM이 있는 Linux가 필요하며, macOS나 Windows에서는 실행할 수 없습니다.
• !라이브 BRANCH에는 Linux 5.7 이상, 벤더링된 Firecracker 포크, userfaultfd 활성화가 필요합니다.
• !프로젝트가 v0.x 단계이므로 릴리스 간에 인터페이스가 변경될 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

forkd은(는) 무엇인가요?

AI 에이전트를 위한 fork 방식 마이크로VM 샌드박스: 실행 중인 VM을 실시간 BRANCH할 수 있으며, 워밍업된 Firecracker 부모에서 copy-on-write 방식으로 분기하고 KVM으로 격리합니다. forkd는 같은 환경이 필요한 단기 AI 에이전트 샌드박스를 다수 실행하는 워크로드를 위한 Firecracker 기반 마이크로VM 샌드박스 런타임입니다. 부모 VM을 한 번 부팅해 런타임과 의존성을 불러온 뒤 스냅샷을 저장하며 일시 중지합니다. 각 자식은 별도의 Firecracker 프로세스로 실행되고, MAP_PRIVATE로 부모의 메모리 이미지를 매핑합니다. 따라서 자식들은 copy-on-write 방식으로 상주 메모리를 공유하며, 커널을 콜드 부팅하는 대신 약 100ms 만에 시작됩니다.

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

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

forkd은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. forkd의 마지막 커밋은 2026년 10월 22일입니다.

forkd은(는) 어디에 사용할 수 있나요?

요청마다 라이브러리가 미리 로드된 새 샌드박스를 제공하는 코드 인터프리터 세션 실행. 에이전트 평가를 위해 수백 개의 저장소 체크아웃이나 테스트 롤아웃을 병렬로 실행. KVM 격리를 적용한 자체 호스팅 Linux 호스트에서 사용자별 코드 실행 환경 제공. 실행 중인 에이전트의 샌드박스 상태를 분기해 다음 단계의 여러 대안을 시도.

forkd는 어떻게 설치하나요?

README의 설치 섹션에 따라 forkd를 설치합니다 스냅샷 태그에서 샌드박스 3개를 포크합니다: forkd fork --tag py-pandas -n 1

forkd은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/deeplethe/forkd