Skip to content

Install

Already working with an AI coding assistant?

Paste this into its chat — it can set up Gaspatchio for you:

Run `uv add gaspatchio` (or `pip install gaspatchio`) to install Gaspatchio,
then set up its plugin for this editor by following
https://gaspatchio.dev/ai/setup/, then verify with `gspio tutorial list`.

Installation is as simple as:

uv add gaspatchio

New to uv?

uv is a fast Python package and project manager. Install it once and the command above will work:

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Prefer to use a Python you already have? pipx install uv (or pip install uv) works too. Full options are in the uv installation guide.

pip install gaspatchio

Check it worked

Gaspatchio installs as the gaspatchio package but imports as gaspatchio:

python -c "from gaspatchio import ActuarialFrame; print('gaspatchio ready')"

With uv, prefix the command with uv run:

uv run python -c "from gaspatchio import ActuarialFrame; print('gaspatchio ready')"

For best results, model with an AI coding tool

Gaspatchio is built for AI-powered modelling. Because a model is plain, explicit Python — no proprietary language, no hidden calculations — you can use an AI coding tool to generate, debug, and reconcile gaspatchio models from a plain-language description, then verify every calculation against your existing models. The plugin equips your editor with the framework's patterns, CLI commands, and performance guardrails, so generated code follows gaspatchio's conventions instead of guessing at the API.

In Claude Code, register the marketplace and install the plugin:

/plugin marketplace add gaspatchio/gaspatchio
/plugin install gaspatchio@gaspatchio

Using VS Code, Cursor, or another agent? The two-minute setup for each is on the Plugins page.

Install from source

To build the latest directly from the public repository (a Rust toolchain is required to compile the core):

pip install "git+https://github.com/gaspatchio/gaspatchio.git#subdirectory=bindings/python"

Install from a release wheel

Download the wheel for your platform from the GitHub releases page, then install the file you downloaded (the version and platform tag will match your download — the line below is only an example):

uv pip install gaspatchio-0.5.1-cp313-cp313-macosx_11_0_arm64.whl