smol-machines/smolvm

어떤 프로젝트인가요?

핵심 기능

• 01macOS, Linux, Windows에서 각자의 게스트 커널을 갖춘 하드웨어 격리 microVM을 실행합니다.
• 02Docker 데몬 없이 표준 OCI 이미지를 실행합니다.
• 03Node, Python, Rust용 임베디드 SDK를 제공합니다.
• 04RAM, CPU, 디스크 상태를 캡처하는 라이브 브랜칭과 체크포인트를 지원합니다.
• 05머신을 포터블한 .smolmachine 파일로 패키징합니다.
• 06네트워킹은 기본적으로 비활성화되며, 호스트 허용 목록과 자격 증명 대체를 지원합니다.

활용 사례

• 노트북에서 AI 에이전트가 생성한 코드를 격리된 샌드박스에서 실행합니다.
• Smolfile을 사용해 재현 가능한 포터블 개발 환경을 만듭니다.
• SDK를 통해 애플리케이션에 작업별 VM을 임베드합니다.
• RuntimeClass를 통해 Kubernetes에서 파드를 microVM으로 실행합니다.

빠른 시작

1. 1

   Homebrew로 설치(macOS)

   brew install smol-machines/tap/smolvm
2. 2

   일회성 VM을 실행하고 커널 정보 출력

   smolvm machine run --net --image alpine -- uname -a
3. 3

   VM에서 대화형 셸 열기

   smolvm machine run --net -it --image alpine -- /bin/sh

사용 전 알아둘 점

• !README에 따르면 Windows에서는 GPU 가속을 사용할 수 없습니다.
• !Intel Mac용 릴리스 빌드는 공개되지 않았으며 테스트도 거치지 않았습니다.
• !Linux에서는 KVM(/dev/kvm)이 필요하고, Windows에서는 Windows Hypervisor Platform을 활성화해야 합니다.

토픽

자주 묻는 질문

smolvm은(는) 무엇인가요?

하드웨어 격리 환경에서 AI 에이전트와 신뢰할 수 없는 코드를 로컬로 실행하는 Rust 기반 임베디드형 포터블 microVM smolvm은 각 워크로드를 자체 게스트 커널을 갖춘 하드웨어 가상화 microVM에서 실행합니다. libkrun을 기반으로 하며 macOS에서는 Hypervisor.framework, Linux에서는 KVM, Windows에서는 Windows Hypervisor Platform을 사용합니다. 이미지는 Docker Hub나 ghcr.io 같은 레지스트리에서 가져오는 표준 OCI 이미지이므로 Docker 데몬이 필요하지 않습니다. CLI에서 머신을 생성하고 시작하거나, 내부에서 명령을 실행하고, 재시작 후에도 유지되도록 저장할 수 있습니다.

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

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

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

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

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

노트북에서 AI 에이전트가 생성한 코드를 격리된 샌드박스에서 실행합니다. Smolfile을 사용해 재현 가능한 포터블 개발 환경을 만듭니다. SDK를 통해 애플리케이션에 작업별 VM을 임베드합니다. RuntimeClass를 통해 Kubernetes에서 파드를 microVM으로 실행합니다.

smolvm는 어떻게 설치하나요?

Homebrew로 설치(macOS): brew install smol-machines/tap/smolvm 일회성 VM을 실행하고 커널 정보 출력: smolvm machine run --net --image alpine -- uname -a VM에서 대화형 셸 열기: smolvm machine run --net -it --image alpine -- /bin/sh

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

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/smol-machines/smolvm