BitMiracle-AI/Dormice

자체 호스팅 AI 에이전트 샌드박스 플랫폼 — 한 대의 머신에서 영구 샌드박스를 저비용으로 운영하세요.

설치형 도구맘대로 써도 됨 · Apache-2.0데브옵스·인프라TypeScript난이도
334+186이번 주0
29포크17이슈

중간맛 분석

TypeScript/Node.js 기반 자체 호스팅 샌드박스 플랫폼입니다. 단일 바이너리로 배포되며, + gVisor를 사용해 실제 샌드박스를 실행합니다. 핵심은 acquireSandbox(userKey) — 같은 키로 호출하면 같은 샌드박스를 얻고, 없으면 생성하고, 중지되었으면 시작합니다. 라이프사이클은 active → frozen → stopped → archived로 자동 진행되며, 깨우기는 약 50ms입니다. E2B 와 호환되며, 웹 콘솔, (dor), 네이티브 TypeScript 를 제공합니다. 초기 개발 단계이며 프로덕션 준비는 안 됨.

이런 레포예요

이럴 때 쓰면 좋아요

  • AI 에이전트에게 안전한 코드 실행 환경 제공하기
  • 클라우드 샌드박스 비용 절감(자체 인프라)
  • long-running 에이전트의 상태 보존 및 재개

핵심 기능

자동 라이프사이클 관리(active→frozen→stopped→archived)E2B SDK 호환성으로 기존 코드 재사용메모리 압축 기술로 유휴 비용 최소화

대안 대비 차별점

클라우드 샌드박스와 달리 자신의 머신에서 영구 샌드박스를 운영하며 유휴 상태에서 거의 비용이 들지 않고, 같은 키로 항상 같은 샌드박스를 얻는 멱등성을 기본으로 제공합니다.

먹어본 사람들

실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.

시식평 · 먹어본 사람 한마디

아직 시식평이 없어요. 먹어보셨다면 첫 한마디를 남겨주세요.

다른 레포 시식평 구경하기 →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

이 레포, 해먹는 법

처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.

준비물

  • Linux x86_64 호스트(Ubuntu/Debian)
  • Docker 및 gVisor(runsc)
  • root 권한
  • 메모리 스왑 활성화 및 vm.swappiness=100
  • Node.js 22+

바로 차려먹기Node.js (pnpm)

깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.

git clone --depth 1 https://github.com/BitMiracle-AI/Dormice.git &&
cd Dormice &&
pnpm install

실행 명령은 README를 확인하세요.

코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.

README가 안내하는 자세한 단계 보기
  1. Ubuntu/Debian x86_64 호스트에서 설치 명령어 실행
curl -fsSL https://raw.githubusercontent.com/BitMiracle-AI/Dormice/main/deploy/install.sh | bash
  1. 설치 완료 후 프로젝트 레포지토리를 클론하고 TypeScript SDK 빌드
pnpm install
pnpm build
  1. 환경변수에서 API 토큰과 엔드포인트 확인
echo $DORMICE_API_TOKEN
  1. 네이티브 TypeScript SDK로 샌드박스 생성 및 명령어 실행
import { Dormice } from '@dormice/sdk';
const client = new Dormice({
  endpoint: 'http://127.0.0.1:3676',
  token: process.env.DORMICE_API_TOKEN!,
});
await client.acquireSandbox('my-agent', { policy: { stopAfterSeconds: null } });
const result = await client.execCommand('my-agent', 'python3 -c "print(6 * 7)"');
console.log(result.exitCode, result.stdout);
  1. 또는 CLI로 샌드박스 관리
dor sandbox ls
dor sandbox exec my-agent 'echo hello'
  1. 웹 콘솔 접속
# SSH 터널 또는 리버스 프록시로 http://127.0.0.1:3676/console에 접속

깃밥트라이로 맛보기

받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.

터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.

npx gitbap-try BitMiracle-AI/Dormice

Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →

이걸로 써먹는 법

맛봤다면 이제 써먹을 차례 — 이 레포를 내 일과 사업에 응용하는 방법을 모아뒀어요.

🍳 레시피 — AI에게 이대로 시켜보세요

레시피 불러오는 중…

별 추이 · 7일

334+186 / 7일

활용성 · 따라 만들기 좋은가

따라 하기 좋음샘플 점수 50/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2026년 생성

「데브옵스·인프라」 이런 레포, 매주 받아보실래요?

매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.

내 레포인가요? README에 깃밥 배지 달기
[![깃밥](https://www.gitbap.com/badge/BitMiracle-AI/Dormice.svg)](https://www.gitbap.com/r/BitMiracle-AI/Dormice)
🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기