Metadata-Version: 2.4
Name: qemu-tool
Version: 1.4.0
Summary: CLI tool for running and generating QEMU VMs
Author: Stephen Bates
License-Expression: MIT
Project-URL: Homepage, https://github.com/sbates130272/qemu-minimal
Project-URL: Repository, https://github.com/sbates130272/qemu-minimal
Project-URL: Changelog, https://github.com/sbates130272/qemu-minimal/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/sbates130272/qemu-minimal/issues
Keywords: qemu,kvm,vm,vfio,cloud-init,libvirt,rocm
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Emulators
Classifier: Topic :: System :: Systems Administration
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# qemu-tool

A single CLI for creating and running QEMU virtual machines: cloud-init image
generation for x86_64, ARM64 and RISC-V, a flexible runner with NVMe, VFIO,
CXL, VirtFS and QMP support, and libvirt domain XML round-tripping.

```bash
pipx install qemu-tool
qemu-tool gen-vm --vm-name vm1 --arch x86_64
qemu-tool run-vm --vm-name vm1 --ssh-port 2222
```

The wheel bundles its compose stacks and package manifests, so a rootless
install is fully functional. Settings come from
`$XDG_CONFIG_HOME/qemu-tool/env` and images default to
`$XDG_DATA_HOME/qemu-tool/images`. Installing the Debian package instead
puts both at their system locations.

Full documentation, the Docker Compose stacks and the Ansible playbooks live
in the [qemu-minimal repository](https://github.com/sbates130272/qemu-minimal).
