Skip to main content
Angreal Documentation
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage
  1. Angreal Documentation
  2. /
  3. How-to Guides
  4. /
  5. Work with Virtual Environments
Edit page

Work with Virtual Environments

Work with Virtual Environments

Angreal provides virtual environment management using UV, a fast Python package installer and resolver.

Overview

The virtual environment integration provides:

  • Create and manage virtual environments
  • Install packages and requirements
  • Ensure specific Python versions
  • Automatic environment activation for tasks

Basic Usage 

from angreal.integrations.venv import VirtualEnv


# Create a new environment
venv = VirtualEnv("myproject-env")

# Install packages
venv.install_packages(["django", "requests"])

# Install from requirements file
venv.install_requirements("requirements.txt")

Using with Tasks 

from angreal.integrations.venv import venv_required
import angreal

@angreal.command(name="analyze", about="Run data analysis")
@venv_required(".venv", requirements=["pandas", "numpy"])

def analyze_data():
    """This function runs in an isolated environment."""
    import pandas as pd
    import numpy as np
    # Your code here

Python Version Management 

from angreal.integrations.venv import VirtualEnv


# Create environment with specific Python version
venv = VirtualEnv("py312-env", python="3.12")

# List available Python versions
pythons = VirtualEnv.discover_available_pythons()
for version, path in pythons:
    print(f"{version}: {path}")

Next Steps