GuestKit

Offline VM intelligence and migration assurance.

Inspect QCOW2, VMDK, and RAW images without powering them on. Score boot probability, generate hypervisor-aware fix plans, and explore disks from a carbon-themed TUI — pure Rust, no libguestfs appliance.

┌──────────────────────────────────────────────────────────────┐
│  Interfaces   guestkit CLI · guestctl TUI · Python bindings  │
├──────────────────────────────────────────────────────────────┤
│  Engine       Pure Rust disk parser · boot scoring · fixes   │
├──────────────────────────────────────────────────────────────┤
│  Outputs      JSON · YAML · HTML · PDF · CI gate artifacts   │
└──────────────────────────────────────────────────────────────┘

Why GuestKit

Problem	GuestKit answer
"Will it boot?" answered at power-on	Offline doctor score before cutover
guestfish scripts don't scale	Structured assurance APIs + exports
Migration surprises cost weekends	Fix plans with driver injections
Fleet drift is invisible	`fleet analyze` and forensic diff
No VM boot for deep inspection	Carbon TUI explores partitions in place

Pairs with: hyper2kvm for VMware → KVM pipelines.

Platform at a Glance

Layer	What's in the repo
Core	Pure Rust disk engine — `crates/`, `src/`
CLI	`guestkit` + `guestctl` — doctor, migrate-plan, fleet
TUI	Carbon-themed multi-view dashboard
Python	`hypersdk-guestkit` on PyPI
K8s	KubeVirt integration hooks — `k8s/`
Deploy	Docker, remote deploy scripts — `deploy/`

Quick Start

cargo install guestkit   # guestkit + guestctl

guestkit doctor vm.qcow2 --target proxmox --explain
# → boot probability · blockers · root-cause chain

guestkit migrate-plan vm.vmdk --target proxmox --export plan.yaml
# → migration score · driver injections · fix plan

guestctl tui vm.qcow2
# → carbon TUI · Assurance · fix-plan preview

Scenario	Path
Getting started	docs/user-guides/getting-started.md
CLI reference	docs/user-guides/cli-guide.md
Migration assurance	docs/features/migration-assurance.md
CE vs Enterprise	docs/ce-vs-enterprise.md

Three Commands Before Cutover

Command	Outcome
`guestkit doctor`	Boot probability + blockers
`guestkit migrate-plan`	Executable fix plan YAML
`guestctl tui`	Interactive assurance workspace

Documentation

Goal	Document
Docs index	docs/README.md
User stories	docs/USER_STORIES.md
Architecture	docs/architecture/overview.md
Full index	docs/INDEX.md

→ zyvor.dev/guestkit · Demo video

Zyvor Platform Stack

Product	Role
hypercluster	Bare-metal Kubernetes bootstrap
machina	Physical hypervisor OS (libvirt/KVM)
zeus-os	Cloud / KubeVirt control plane
hermes	Application layer for Kubernetes
forge	AI infrastructure on Kubernetes
hypersdk / hyper2kvm	Multi-cloud VM migration
guestkit	Offline VM migration assurance
packetwolf	Kernel-native network intelligence
Aether	Universal runtime portability
Veyron	KubeVirt VM command center
IronWolf	Metal3 bare-metal automation
zyvor-fabric	systemd-native private cloud

→ zyvor.dev

Development

See project docs for CI, testing, and contribution guidelines. Historical build summaries in the repo root are snapshots — docs/ and this README are authoritative.

License

See LICENSE or project-specific licensing files in docs/legal/.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

hypersdk_guestkit-0.3.12-cp311-cp311-manylinux_2_39_x86_64.whl (1.8 MB view details)

Uploaded Jul 10, 2026 CPython 3.11manylinux: glibc 2.39+ x86-64

File details

Details for the file hypersdk_guestkit-0.3.12-cp311-cp311-manylinux_2_39_x86_64.whl.

File metadata

Download URL: hypersdk_guestkit-0.3.12-cp311-cp311-manylinux_2_39_x86_64.whl
Upload date: Jul 10, 2026
Size: 1.8 MB
Tags: CPython 3.11, manylinux: glibc 2.39+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: maturin/1.14.1

File hashes

Hashes for hypersdk_guestkit-0.3.12-cp311-cp311-manylinux_2_39_x86_64.whl
Algorithm	Hash digest
SHA256	`b0b4efb4e2478a97a61d6e85b5de62674ca34ee91429eb686535986a64e722cf`
MD5	`799f716c69938fd3e2f69dd49aea628b`
BLAKE2b-256	`688a2fd7361d7cda10e514b4229480e8edd2a1d01e0aa210613f2506a04f6608`