Quick Start
Get up and running with Angreal in just a few minutes.
- Python 3.8 or higher
- pip (Python package installer)
- Git (for template installation)
Install the latest stable version:
pip install angreal
Install the latest development version:
pip install git+https://github.com/angreal/angreal.git
For contributing to Angreal:
# Clone the repository
git clone https://github.com/angreal/angreal.git
cd angreal
# Angreal uses itself for development setup!
pip install angreal # Install angreal first
angreal dev install # Set up development environment
# This will:
# - Create a .venv virtual environment
# - Install maturin, pre-commit, and pytest
# - Set up pre-commit hooks
# - Check for required system dependencies (Hugo, Cargo)
After installation, verify that Angreal is working:
angreal --version
# Expected output: angreal 2.2.0 (or current version)
You can also check available commands:
angreal --help
- Create a new directory for your project:
mkdir my-project
cd my-project
- Create an
.angreal
directory:
mkdir .angreal
- Create your first task file
.angreal/task_hello.py
:
import angreal
@angreal.command(name="hello", about="Say hello")
@angreal.argument(name="name", long="name", help="Name to greet", required=False)
def hello_command(name="World"):
"""A simple hello world task."""
print(f"Hello, {name}!")
- Run your task:
angreal hello
# Output: Hello, World!
angreal hello --name Alice
# Output: Hello, Alice!
Angreal can create projects from templates:
# Initialize from a GitHub template
angreal init https://github.com/angreal/python.git my-new-project
# Or use a local template
angreal init /path/to/template my-new-project
# Answer the prompts to customize your project
Popular templates:
https://github.com/angreal/python.git
- Python project templatehttps://github.com/angreal/rust.git
- Rust project template
If angreal
is not found after installation, ensure your Python Scripts directory is in your PATH:
- Linux/macOS:
~/.local/bin
- Windows:
%APPDATA%\Python\Scripts
If you get import errors, ensure you’re using Python 3.8+ and have installed all dependencies:
python --version # Should be 3.8 or higher
pip install --upgrade angreal
- Learn more about creating tasks
- Explore project templates
- Read the API reference