Skip to content
kzshPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

67 Commits

Folders and files

Repository files navigation

snark

A small single-host service that runs Debian 13 virtual machines on Firecracker and gives each one its own SSH credentials. Clients ask an authenticated HTTPS API for a VM; the service boots it, generates an Ed25519 keypair, installs the public key in the guest, and returns the private key, the host and port to connect to, and the guest's SSH host key. On the machine it was developed on, a VM is reachable over SSH about 6 seconds after the request.

It is meant for one machine dedicated to the task, for example to hand out disposable Linux machines to people, CI jobs or LLM agents on a LAN. It is not a cluster scheduler, a container runtime or a general-purpose VM manager.

Quick start

On the host (Linux x86_64 with KVM, Debian or Ubuntu):

git clone https://github.com/kzsh/snark.git
cd snark
sudo ./setup/install.sh

On a client computer:

curl -fsSL https://<host>/install.sh | sh
snark login            # paste the token from: sudo cat /etc/snark/api-token
snark create --name web
snark ssh web

Documentation

Related projects

These cover overlapping ground and may fit some needs better:

  • ejc3/fcvm runs Podman containers inside Firecracker or Cloud Hypervisor VMs, with snapshot-based fast starts, VM cloning and an HTTP API. It works with container images rather than full Debian systems reached over SSH.
  • NVIDIA OpenShell is a policy-enforcing sandbox runtime for AI agents, with its own gateway and CLI.
  • firecracker-containerd and Kata Containers run containers in microVMs through container runtimes.
  • E2B is an open-source sandbox platform built on Firecracker, designed for multi-node deployments.
  • Fly.io Machines is a hosted service whose API design (asynchronous create with a wait endpoint, a per-host daemon with a persisted state machine) influenced this one.

License

Apache License 2.0, see LICENSE and NOTICE.

The repository contains only this project's own code. Things it downloads or builds at install time keep their own licenses: Firecracker (Apache-2.0), the Debian image (various free licenses) and the guest kernel (GPL-2.0). These are used on the host and not redistributed by this project; if you publish built images, their licenses apply to you.

The prebuilt client binaries statically link Rust crates, the Rust standard library and, on Linux, musl libc, all under permissive licenses (Apache-2.0, MIT, ISC, BSD-3-Clause, Zlib, Unicode-3.0, CDLA-Permissive-2.0). client-rs/build-dist.sh generates THIRD-PARTY-LICENSES with cargo-about; snarkd serves it with LICENSE and NOTICE under /dl/, and the client installer saves all three to ~/.local/share/snark/licenses/.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages