{"id":50263704,"url":"https://github.com/0xchasercat/volant","last_synced_at":"2026-06-01T11:32:51.617Z","repository":{"id":317907796,"uuid":"1068789513","full_name":"0xchasercat/volant","owner":"0xchasercat","description":"Modular orchestration engine for microvms","archived":false,"fork":false,"pushed_at":"2026-04-28T08:44:37.000Z","size":238406,"stargazers_count":39,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-27T12:24:32.617Z","etag":null,"topics":["ai","cloud","cloud-native","container","devops","docker","edge","firecracker","gpu","hypervisor","infrastructure","kvm","machine-learning","microvm","orchestration","self-hosted","serverless","vfio","virtualization","vm"],"latest_commit_sha":null,"homepage":"https://volantvm.com","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xchasercat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-02T23:06:23.000Z","updated_at":"2026-05-21T00:15:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"032b3d4f-dbb3-4502-91c0-8e09a8fff63c","html_url":"https://github.com/0xchasercat/volant","commit_stats":null,"previous_names":["volantvm/volant","ccheshirecat/volant","0xchasercat/volant"],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/0xchasercat/volant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xchasercat%2Fvolant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xchasercat%2Fvolant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xchasercat%2Fvolant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xchasercat%2Fvolant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xchasercat","download_url":"https://codeload.github.com/0xchasercat/volant/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xchasercat%2Fvolant/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33773773,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","cloud","cloud-native","container","devops","docker","edge","firecracker","gpu","hypervisor","infrastructure","kvm","machine-learning","microvm","orchestration","self-hosted","serverless","vfio","virtualization","vm"],"created_at":"2026-05-27T12:07:34.902Z","updated_at":"2026-06-01T11:32:51.612Z","avatar_url":"https://github.com/0xchasercat.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"banner.png\" alt=\"VOLANT — The Intelligent Execution Cloud\"/\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/volantvm/volant/actions\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/volantvm/volant/ci.yml?branch=main\u0026style=flat-square\u0026label=tests\" alt=\"Build Status\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/volantvm/volant/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/volantvm/volant.svg?style=flat-square\" alt=\"Latest Release\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://golang.org/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Go-1.22+-black.svg?style=flat-square\" alt=\"Go Version\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/volantvm/volant/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/License-BSL_1.1-black.svg?style=flat-square\" alt=\"License\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n💡 Need help deploying or extending this? → hello@volantvm.com\n\n---\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/ccheshirecat/volant-demo/raw/refs/heads/main/demo.gif\" width=\"800\" /\u003e\n\u003c/p\u003e\n\n\n# Volant\n\n\u003e **The modular microVM orchestration engine.**\n\nVolant lets you spin up fully isolated microVMs as easily as running a container — with real kernels, VFIO passthrough, and cloud-init built in.\n\n\nVolant turns microVMs into a first-class runtime surface. The project ships a control plane, CLI, and agent that speak a common image manifest so teams can run secure, stateful workloads without stitching together networking, scheduling, and lifecycle plumbing themselves.\n\nRuntime-specific behavior lives in signed manifests and their associated artifacts. The core engine stays lean while image authors ship the kernels/initramfs overlays and workload processes their runtime requires. Operators decide which manifests to install and must reference one whenever a VM is created.\n\nTogether with fledge — the artifact builder — Volant provides a complete solution for building and deploying microVMs with custom applications embedded in initramfs, or with the regular OCI images we are familiar with.\n\nCloud-init support makes Volant ideal for dev sandboxes, while VFIO passthrough allows for isolation of GPU and AI workloads.\n\n## Batteries Included By Default\n\nVolant ships with sensible defaults out of the box, lowering the barrier to entry while keeping full configurability for power users\n\nHowever, Volant is built to be modular, scriptable and configurable beyond those defaults, and advanced users can customize it to their own needs.\n\nFor instance, the Kestrel agent acts as a robust PID1 and is responsible for setting up the guest environment in multiple scenarios, and also acts as a secure proxy to workloads inside network-isolated VMs over vsock, providing a frictionless path to maximum isolation.\n\nIf you require more fine-grained control, it is possible to override the kernel paths and the fledge artifact builder has configuration settings for using your own init. Refer to the documentation for more details.\n\n---\n\n## Overview\n\nVolant provides:\n\n- **`volantd`** — Control plane (SQLite registry + VM orchestration)\n- **`volar`** — CLI for managing VMs and images\n- **`kestrel`** — In-guest agent \u0026 init (PID 1)\n- **`driftd`** — L4 load balancer with eBPF dataplane (TC-based NAT/port forwarding)\n- **[`fledge`](https://github.com/volantvm/fledge)** — Image builder (OCI images → bootable artifacts)\n\n**Two paths, same workflow**:\n\n1. **[`Rootfs strategy`](https://github.com/volantvm/oci-image-example)** — Convert OCI images to bootable disk images (Docker compatibility)\n2. **[`Initramfs strategy`](https://github.com/volantvm/initramfs-image-example)** — Build custom appliances from scratch (maximum performance)\n\n---\n\n## Quick Start\n\nSpin up your first microVM in under a minute.\n\n---\n\n### 1. Install the Volant toolchain\n```bash\n# This installs volar (CLI), volantd (control plane), kestrel (guest agent),\n# driftd (L4 load balancer), and default kernels to /var/lib/volant/kernel.\n# By default, setup creates a bridge (vbr0) at 192.168.127.1/24.\n\ncurl -fsSL https://get.volantvm.com | bash\n```\n\n**Tip:** To inspect or customize network setup later:\n```bash\nsudo volar setup --help\n```\n\nIf you prefer to **skip automatic setup** and handle networking yourself:\n```bash\ncurl -fsSL https://get.volantvm.com | bash -s -- --skip-setup\n```\n\n---\n\n### 2. Install a pre-built image\n\nLet's start with a Caddy initramfs image [(initramfs-image-example)](https://github.com/volantvm/initramfs-image-example)\n\n```bash\nvolar images install --manifest \\\n  https://github.com/volantvm/initramfs-image-example/releases/latest/download/caddy.json\n```\n\n---\n\n### 3. Create and run your first VM\n```bash\nvolar vms create web --image caddy --cpu 2 --memory 512\n```\n\nCheck it's alive:\n```bash\ncurl 192.168.127.10\n# → Hello from Caddy in a Volant microVM! 🚀\n```\n\n---\n\n### 4. Try a Docker-based workload [(oci-image-example)](https://github.com/volantvm/oci-image-example)\n\nThis example runs **NGINX** directly from the official Docker image:\n```bash\nvolar images install --manifest \\\n  https://github.com/volantvm/oci-image-example/releases/latest/download/nginx.json\n\nvolar vms create my-nginx --image nginx --cpu 1 --memory 1024\ncurl http://192.168.127.11\n```\n\n---\n\n### 5. Scale declaratively (Kubernetes-style)\n\n```bash\ncat \u003e web-config.json \u003c\u003c'EOF'\n{\n  \"image\": \"caddy\",\n  \"resources\": {\n    \"cpu_cores\": 2,\n    \"memory_mb\": 512\n  }\n}\nEOF\n\nvolar deployments create web-cluster \\\n  --config web-config.json \\\n  --replicas 5\n```\n\n**Result:** 5 isolated microVMs, each with its own kernel, IP, and lifecycle management.\n\n---\n\n**Done** — you've just deployed a replicated microVM cluster with real kernel isolation, no YAMLs, and zero boilerplate.\n\n\n\n### Build Your Own Images\n\nUse **[fledge](https://github.com/volantvm/fledge)** to build custom images from OCI images or static binaries.\n\n**Examples**:\n- [initramfs-image-example](https://github.com/volantvm/initramfs-image-example) — Caddy web server (fast boot, minimal size)\n- [oci-image-example](https://github.com/volantvm/oci-image-example) — NGINX from Docker image (Docker compatibility)\n\n\n---\n\n## Why Volant?\n\n| Feature | Containers | Volant microVMs |\n|---------|-----------|----------------|\n| **Isolation** | Kernel shared | Hardware-level (dedicated kernel) |\n| **Boot time** | ~1s | 50-150ms (initramfs) / 2-5s (rootfs) |\n| **Image size** | 80 MB (NGINX) | 20 MB (full appliance) |\n| **Security** | Namespaces | Full VM isolation |\n| **Overhead** | Shared kernel | ~25 MB per VM |\n| **Networking** | NAT/bridge/overlay | Simple Linux bridge |\n| **GPU Passthrough** | Limited | Native VFIO for AI/ML |\n\n---\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────┐\n│                   Host Machine                      │\n│  ┌──────────────────────────────────────────────┐   │\n│  │         volantd (Control Plane)              │   │\n│  │  • SQLite registry                           │   │\n│  │  • IPAM (192.168.127.0/24)                   │   │\n│  │  • Cloud Hypervisor orchestration            │   │\n│  │  • REST + MCP APIs                           │   │\n│  └─────────────────┬────────────────────────────┘   │\n│                    │                                 │\n│  ┌─────────────────┴────────────────────────────┐   │\n│  │    driftd (L4 Load Balancer / NAT)           │   │\n│  │  • eBPF TC ingress/egress programs           │   │\n│  │  • Port forwarding (host → VM)               │   │\n│  │  • Stateful connection tracking              │   │\n│  │  • Auto-detect external interface            │   │\n│  └─────────────────┬────────────────────────────┘   │\n│                    │                                 │\n│  ┌─────────────────▼────────────────────────────┐   │\n│  │          Bridge Network (vbr0)               │   │\n│  └┬────────┬────────┬────────┬──────────────────┘   │\n│   │        │        │        │                       │\n│  ┌▼──┐   ┌▼──┐   ┌▼──┐   ┌▼──┐                     │\n│  │VM1│   │VM2│   │VM3│   │VMN│                     │\n│  │┌──┐   │┌──┐   │┌──┐   │┌──┐                     │\n│  ││🔒│   ││🔒│   ││🔒│   ││🔒│                     │\n│  │└──┘   │└──┘   │└──┘   │└──┘                     │\n│  └───┘   └───┘   └───┘   └───┘                     │\n│   kestrel agents (PID 1)                            │\n└─────────────────────────────────────────────────────┘\n```\n\n**Kernel and boot**:\n- Each Volant release ships verifiably-built kernels: bzImage (compressed) and vmlinux (uncompressed ELF)\n- Both contain the same embedded initramfs with kestrel agent and C init\n- Embedded init handles both boot paths: stays in initramfs for appliance workloads, or pivots to rootfs for OCI-based workloads\n- bzImage used by default; vmlinux available for power users who need the uncompressed format\n- SHA256 checksums + build provenance attestation for all artifacts\n\n### Web UI and API\n\n- CORS: set `VOLANT_CORS_ORIGINS=\"http://localhost:3000,https://app.example.com\"` to enable browser-based UIs\n- IP allowlist: `VOLANT_API_ALLOW_CIDR=\"127.0.0.1/32,192.168.0.0/16\"`\n- API key: `VOLANT_API_KEY=...` then send header `X-Volant-API-Key: \u003ckey\u003e`\n- System summary: `GET /api/v1/system/summary`\n- VM list with filters/pagination: `GET /api/v1/vms?status=running\u0026runtime=browser\u0026image=caddy\u0026q=web\u0026limit=20\u0026offset=0\u0026sort=created_at\u0026order=desc` (returns `X-Total-Count`)\n- Console WebSocket: `GET ws://\u003chost\u003e/ws/v1/vms/:name/console` (raw serial bridge)\n- Image artifacts API:\n  - List: `GET /api/v1/images/:image/artifacts?version=v1`\n  - Upsert: `POST /api/v1/images/:image/artifacts`\n  - Delete: `DELETE /api/v1/images/:image/artifacts?version=v1`\n\nVM-level device overrides (VFIO):\n\n```json\n{\n  \"devices\": {\n    \"vfio\": [\"0000:01:00.0\", \"0000:01:00.1\"]\n  }\n}\n```\nApply with `PATCH /api/v1/vms/:name/config` or via `volar` config patching.\n\n---\n\n## Use Cases\n\n- **Secure multi-tenancy** — True hardware isolation\n- **Edge computing** — Minimal footprint, fast boot\n- **CI/CD** — Ephemeral test environments\n- **Development** — Local Kubernetes-style orchestration\n- **High-density workloads** — 50-100 VMs per host\n- **AI/ML** Run machine learning workloads in isolation\n\n---\n\n## Documentation\n\n**Full documentation**: [docs.volantvm.com](https://docs.volantvm.com)\n\nQuick links:\n- [Why Volant](docs/1_introduction/0_why-volant.md)\n- [Installation Guide](docs/2_getting-started/1_installation.md)\n- [Quick Starts](docs/2_getting-started/2_quick-start-initramfs.md) · [Rootfs](docs/2_getting-started/3_quick-start-rootfs.md)\n- [Networking](docs/3_guides/1_networking.md) · [Cloud-init](docs/3_guides/2_cloud-init.md) · [Deployments](docs/3_guides/3_deployments.md) · [GPU](docs/3_guides/4_gpu-passthrough.md)\n- [Image Development](docs/4_image-development/1_overview.md) · [Initramfs](docs/4_image-development/2_initramfs.md) · [OCI Rootfs](docs/4_image-development/3_oci-rootfs.md)\n- [Architecture Overview](docs/5_architecture/1_overview.md)\n- [Reference: Manifest](docs/6_reference/1_manifest-schema.md) · [fledge.toml](docs/6_reference/2_fledge-toml.md) · [manifest.toml](docs/6_reference/3_manifest-toml.md) · [CLI](docs/6_reference/cli-volar.md) · [OpenAPI](docs/6_reference/api/openapi.json)\n- [Contributing](docs/7_development/1_contributing.md) · [Security](docs/7_development/2_security.md)\n\n---\n\n## Roadmap\n\nSee [ROADMAP.md](ROADMAP.md) for the full vision.\n\n~~[**2025 Q3-Q4**: **VFIO GPU passthrough**](https://github.com/volantvm/volant/releases/tag/v0.6.0) — Native GPU support for AI/ML workloads~~\n- **2025 Q4**: PaaS mode — serverless-like workloads, boot from snapshot\n- **2025 Q4**: Multi-node clustering support\n\n---\n\n## Community\n\n- **GitHub**: [github.com/volantvm/volant](https://github.com/volantvm/volant)\n- **Discord**: *(coming soon)*\n- **Email**: hello@volantvm.com\n\n**Contributing**: See [contributing]([docs/7_development/1_contributing.md](https://docs.volantvm.com/contributing-1646061m0))\n\n---\n\n## License\n\n**Business Source License 1.1** — free for personal, educational, and internal use.\nCommercial hosting or resale requires a license from HYPR PTE. LTD.\nConverts to **Apache 2.0** on **October 4, 2029**.\n\nSee [LICENSE](LICENSE) for full terms.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eVolant\u003c/strong\u003e — \u003cem\u003eDesigned for stealth, speed, and scale.\u003c/em\u003e\n\u003c/p\u003e\n\n\n---\n\n**© 2025 HYPR PTE. LTD.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xchasercat%2Fvolant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xchasercat%2Fvolant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xchasercat%2Fvolant/lists"}