Skip to content

Installation

threvo-actions supports Python 3.11, 3.12, and 3.13.

Release availability

These commands install the immutable 0.1.3 release after the signed tag has completed the TestPyPI and PyPI release workflow. Never install a moving branch for a financial-action runtime.

python -m pip install "threvo-actions==0.1.3"

uv add "threvo-actions==0.1.3"

The core package depends only on Pydantic and the Python standard library.

Optional integrations

python -m pip install "threvo-actions[postgres]==0.1.3"

python -m pip install "threvo-actions[mysql]==0.1.3"

Use the official MySQL 8 adapter for production-oriented multi-worker evaluation. See the MySQL guide.

python -m pip install "threvo-actions[sqlalchemy]==0.1.3"

The host-framework recipe uses SQLAlchemy for application business data, the qualified asyncpg action stores, and Alembic as deployment orchestration. See SQLAlchemy and Alembic.

python -m pip install "threvo-actions[pydantic-ai]==0.1.3"

The integration pins the Pydantic AI version it is tested against but does not install a model-provider SDK. Add the provider extra your application uses.

SQLite support uses the Python standard library, so the base installation already includes it:

python -m pip install "threvo-actions==0.1.3"

It is supported for local development, evaluation, tests, and bounded single-writer deployments. See the SQLite guide.

git clone https://github.com/BlackPigIndustries/threvo-actions.git
cd threvo-actions
uv sync --extra dev --extra mysql --extra pydantic-ai --extra postgres --extra docs
uv run mkdocs serve

Verify the installation

python - <<'PY'
from decimal import Decimal

from threvo_actions import Money

amount = Money(amount=Decimal("19.95"), currency="EUR")
print(amount.model_dump(mode="json"))
PY

Output:

{'amount': '19.95', 'currency': 'EUR'}

The model is strict and immutable. It rejects a floating-point amount, a lowercase currency, unexpected fields, or later mutation.

Give your coding agent the library skill

The distribution includes an Agent Skills-compatible guide with the current authoring API, safety boundaries, Pydantic AI wiring, and test matrix. Locate the exact copy bundled with the installed package:

threvo-actions skill path

Install that directory with a compatible skill manager:

THREVO_ACTIONS_SKILL_DIR=$(threvo-actions skill path) || exit 1
npx skills add "$THREVO_ACTIONS_SKILL_DIR" \
  --skill threvo-actions --agent '*' --yes

This uses the skill that shipped with the Python version your application installed. See Coding agents for source, project-local, and global installation options and the upgrade procedure.