Skip to main content

Installation

ActionRail currently ships as two Python packages:

  • actionrail — the runtime SDK used by the agent application;
  • actionrail-console — the optional local control plane and operator UI.

Both packages require Python 3.11 or newer. The local Console does not require Docker, a database service, an account, or sign-up.

During the public beta, install the SDK and Console from the same complete release version. See the compatibility policy and upgrade procedure before changing a production installation.

Integration support

Any Python application can use ActionRuntime by explicitly naming an action and guarding its operation. LangGraph also supports automatic action-surface discovery and tool wrapping. Additional automatic framework adapters are planned.

Public beta

The current 0.1.x packages are beta releases. ActionRail v1 is planned for August 2026.

Install from PyPI​

Create a virtual environment and install the SDK and Console. This is the recommended path for ActionRail users:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install actionrail actionrail-console

For LangGraph projects and the packaged quickstart, install the agents extra:

python -m pip install "actionrail[agents]" actionrail-console

The base actionrail installation is sufficient for the direct Python integration; it does not install LangGraph or LangChain.

Install local beta wheels​

Build both packages from the repository:

python scripts/build_beta_wheels.py

The command writes the SDK wheel, Console wheel, and SHA256SUMS to dist/. Install the generated artifacts into the target virtual environment:

python -m pip install \
  dist/actionrail-*.whl \
  dist/actionrail_console-*.whl

You can share those wheel files directly with a beta tester. They do not need repository access after installation.

Develop ActionRail from source​

Editable installs are for contributors working on ActionRail itself. From the repository root:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[agents]" -e ./control-plane

Application developers using ActionRail do not need a repository checkout.

Optional PostgreSQL driver​

The SDK depends on the Psycopg interface but leaves the libpq implementation to the host application.

For a self-contained local installation:

python -m pip install "psycopg[binary]>=3.2,<4"

Production environments can use the system-linked psycopg[c] build instead.

Verify the commands​

python -c "import actionrail; print('ActionRail SDK ready')"
actionrail-console --version
actionrail-quickstart --help

Continue by starting the local Console, integrate an ordinary Python operation, or run the complete LangGraph quickstart.