virtme-ng

library1.41pypypiunverified

Build and run a kernel inside a virtualized snapshot of your live system. Current version: 1.41. Released approximately weekly.

devops

pip install virtme-ng

github ↗package ↗

INSTALL

IMPORT

SIG · VIRTME-NG

virtme-ng

devopspythonv1.41

Install

2.3s avg

Import

—

Disk

22MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.41 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.910 runs

installs and imports cleanly · install 0.0s · import 0.000s · 23.6MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 2.3s · import 0.000s · 24MB

22MB installed

● package 22MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

VirtmeNGConfig

✓ from virtme_ng.config import VirtmeNGConfig

✗ from virtme_ng import VirtmeNGConfig

Run a kernel inside a virtualized snapshot of your live system.

from virtme_ng.run import VirtmeNGConfig, VirtmeNGRunner config = VirtmeNGConfig(kernel_path='/path/to/bzImage', rootfs='/path/to/rootfs', memory='512M', cpus=2) runner = VirtmeNGRunner(config) runner.run()

virtme-ng --version

Debug

Known issues

breakingIn v1.36, --exec and positional arguments became mutually exclusive. Using both will raise an error.

fix

Separate command and arguments using -- syntax: vng -- uname -r instead of vng --exec uname -r

affects: >=1.36

deprecatedThe virtme-ng-init repository has been merged into main project as of v1.33. Old git submodule references are obsolete.

fix

Run `git submodule deinit virtme-ng-init` and `git rm virtme-ng-init` to clean up old submodule.

affects: <1.33

gotchaDefault SSH transport uses vsock; if guest lacks vsock support, SSH will fail.

fix

Use `--ssh` option to force legacy TCP SSH, or ensure kernel has vsock support.

affects: >=1.34

gotchaStale file handle errors (ESTALE) were common with virtiofsd before v1.38. If you see this, upgrade.

fix

Upgrade to v1.38 or later.

affects: <1.38

Upgrade

Version history

1.41latest on PyPI · released Apr 5, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

10 hits · last 30 days

node

Resources

githubhttps://github.com/arighi/virtme-ng ↗

packagehttps://pypi.org/project/virtme-ng/ ↗