@aixjs/python

Python support for AIX: run tools, agents, workflow steps and background tasks written in Python next to a TypeScript/JavaScript AIX app.

You don't install or import this package directly — @aixjs/aix includes it. Add a .py file that imports aix and run aix dev:

# agents/analyst.py
from aix import agent, tool


@tool(permissions=["database.read"])
async def revenue(year: int, ctx) -> list[dict]:
    """Monthly revenue for a year."""
    return await ctx.db.query("Order", {"year": year})


analyst = agent(name="analyst", instructions="Answer revenue questions.", tools=[revenue], permissions=["database.read"])

import { analyst } from "./agents/analyst.py"; // typed, server-only

What's inside:

• the host side: worker supervision, pools, the AIX protocol (MessagePack frames), capability tokens, environment management (uv / venv), code generation, and remote worker pools over WebSocket + mutual TLS;
• the Python SDK in sdk/aix (pure Python, no required dependencies; uses msgpack and pydantic when installed). Supports Python 3.11–3.14.

Guide: docs/python.md. License: MIT.