python-vagrant

What it is and what it does

Python-vagrant is a thin wrapper around the Vagrant command-line tool that lets you control virtual machines programmatically from Python code. Instead of running vagrant commands manually in a shell, you instantiate a Vagrant object and call methods like up(), destroy(), halt(), and status() to manage VMs. It also provides access to SSH configuration details and supports multi-VM environments, box management, and provisioning options.

The package requires Vagrant 2.2 or greater and a supported hypervisor to be installed separately; it does not bundle or replace Vagrant itself. It has no Python runtime dependencies, making installation straightforward. The module is useful for automation workflows—such as spinning up test environments, integrating VM management into deployment pipelines, or controlling Vagrant from Fabric tasks—where you need programmatic rather than manual control.

Use it for:

• Automate VM startup and teardown in CI/CD pipelines or test suites that need isolated environments
• Integrate Vagrant box control into Fabric deployment tasks to run remote commands on provisioned VMs
• Query and manage multiple VMs in a multi-VM Vagrantfile from a single Python script
• Log and monitor Vagrant subprocess output for debugging or auditing infrastructure changes
• Programmatically initialize VMs from base boxes and manage box lifecycle (add, remove, list)

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Programmatic control of Vagrant virtual machines through Python, wrapping the vagrant command-line tool to start, stop, query status, and manage VMs from code.

Yes, if you need to automate Vagrant VM management from Python and already have Vagrant and a hypervisor installed. The package is actively maintained, has no external Python dependencies, and carries a permissive license. The beta status and 2022 release date mean you should verify compatibility with your Vagrant version, but the straightforward API and low install friction make it a practical choice for automation workflows.

Install

python-vagrant on PyPI

pip install python-vagrant

uv add python-vagrant

poetry add python-vagrant

Installing python-vagrant

Before you install

Low friction installation with no runtime dependencies. Maintenance is active with recent commits, though the latest release was in 2022 and the package is marked beta, so API stability is not guaranteed.

License in practice

MIT license is permissive, allowing commercial and private use with minimal restrictions.

Quickstart

pip install python-vagrant

import vagrant
v = vagrant.Vagrant()
v.up()
print(v.status())
v.halt()

Vagrant 2.2 or greater and a supported hypervisor (VirtualBox, VMWare, etc.) must be installed and configured on the system before python-vagrant can control VMs.

Verify before relying

• Whether Vagrant 2.2+ and a supported hypervisor (VirtualBox, VMWare, etc.) are already installed on the target system
• Performance characteristics when managing large numbers of VMs or complex multi-VM environments
• Compatibility with recent Vagrant versions beyond what the description states

Package facts

Evidence: python_vagrant-1.0.0-py3-none-any.whl

Keywords: box, vagrant, vagrantfile, virtual-machine, virtualbox

Tags

More Utilities packages