Skip to main content

Python Bindings

Repository: https://github.com/liquidos-ai/AutoAgents

The Python bindings exist to make it easy to explore new ideas quickly without giving up the Rust core that powers AutoAgents.

Python stays focused on agent definition, orchestration, experimentation, and callback glue. Rust owns the runtime, scheduling, streaming, concurrency, and core execution model.

Stable vs Experimental

The production path is:

  • Rust-owned executors (BasicAgent, ReActAgent)
  • Rust-owned memory (SlidingWindowMemory and future Rust-backed providers)
  • Python tools
  • Python hooks

Explicit extension paths live under autoagents.experimental:

  • ExperimentalAgentBuilder
  • CustomExecutor
  • Python-backed memory adapters

Those extension APIs are experimental in the Python bindings specifically because they rely on Python-native execution or Python-native memory behavior. That boundary exists to keep production runtime ownership in Rust rather than re-centering the architecture on Python callbacks.

The same categories of capability are production-grade in the Rust-native implementation. What is experimental here is the Python extension path, not the underlying AutoAgents model when implemented natively in Rust.

Why This Matters

  • Rapid iteration in Python is useful when you are prototyping agent flows, hooks, memory adapters, and pipeline layers.
  • Performance-sensitive and safety-critical behavior still comes from the Rust implementation underneath.
  • Moving a successful prototype to production Rust is easier because the Python layer is orchestration-oriented rather than a separate runtime.

Practical Outcome

You can prototype in Python with:

  • the same LLMProvider model
  • the same pipeline composition model
  • the same agent builder structure
  • the same runtime concepts used by the Rust crates

When you decide to harden something for production, the path to Rust is much smaller because the architecture is already aligned.

Installation from PyPI

Install the base package:

pip install autoagents-py

Install with a local backend or guardrails using extras:

pip install "autoagents-py[llamacpp]"           # llama.cpp CPU
pip install "autoagents-py[llamacpp-cuda]"      # llama.cpp CUDA
pip install "autoagents-py[llamacpp-metal]"     # llama.cpp Metal (macOS)
pip install "autoagents-py[llamacpp-vulkan]"    # llama.cpp Vulkan
pip install "autoagents-py[mistralrs]"          # mistral-rs CPU
pip install "autoagents-py[mistralrs-cuda]"     # mistral-rs CUDA
pip install "autoagents-py[mistralrs-metal]"    # mistral-rs Metal (macOS)
pip install "autoagents-py[guardrails]"         # Guardrails
pip install "autoagents-py[llamacpp-cuda,guardrails]"  # Multiple extras

Local Development

From the repository root:

uv venv --python=3.12
source .venv/bin/activate
uv pip install -U pip "maturin>=1.13.3,<2" pytest pytest-asyncio pytest-cov

make python-bindings-build

For local backend work:

make python-bindings-build-llamacpp-only
make python-bindings-build-mistralrs-only

Backend-specific distributables now live in dedicated package directories under bindings/python/ such as autoagents-llamacpp-cuda and autoagents-mistralrs-metal, so local builds and release builds use the same checked-in package metadata.

For full setup and usage details, see:

  • README.md
  • docs/src/getting-started/python-bindings.md

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

autoagents_mistral_rs_py-0.4.0.tar.gz (501.5 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

autoagents_mistral_rs_py-0.4.0-cp39-abi3-manylinux_2_28_x86_64.whl (23.9 MB view details)

Uploaded CPython 3.9+manylinux: glibc 2.28+ x86-64

autoagents_mistral_rs_py-0.4.0-cp39-abi3-manylinux_2_28_aarch64.whl (23.0 MB view details)

Uploaded CPython 3.9+manylinux: glibc 2.28+ ARM64

autoagents_mistral_rs_py-0.4.0-cp39-abi3-macosx_11_0_arm64.whl (21.6 MB view details)

Uploaded CPython 3.9+macOS 11.0+ ARM64

File details

Details for the file autoagents_mistral_rs_py-0.4.0.tar.gz.

File metadata

  • Download URL: autoagents_mistral_rs_py-0.4.0.tar.gz
  • Upload date:
  • Size: 501.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for autoagents_mistral_rs_py-0.4.0.tar.gz
Algorithm Hash digest
SHA256 a8cba160518bf4037028c5b85ad8f8f749fb8f49c053c7fc9c870e18c8da8070
MD5 559e12e89fca130ee582bbed0c4e9b97
BLAKE2b-256 4a4d99bf07c416235cbaca643a2fe85158f09608325b26fe158b18d3ad23cd09

See more details on using hashes here.

Provenance

The following attestation bundles were made for autoagents_mistral_rs_py-0.4.0.tar.gz:

Publisher: python-bindings.yml on liquidos-ai/AutoAgents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file autoagents_mistral_rs_py-0.4.0-cp39-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for autoagents_mistral_rs_py-0.4.0-cp39-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 59f7adcdbce2ede632e66499d5222b6174cbd5e0c243b05c4b8786f8a1a913cd
MD5 30d370fd26e02198bb2cc8f20d31d6aa
BLAKE2b-256 3a914bb0ce894b5ef6c341318930fd81c87477cd586abc31fd087a000e15650e

See more details on using hashes here.

Provenance

The following attestation bundles were made for autoagents_mistral_rs_py-0.4.0-cp39-abi3-manylinux_2_28_x86_64.whl:

Publisher: python-bindings.yml on liquidos-ai/AutoAgents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file autoagents_mistral_rs_py-0.4.0-cp39-abi3-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for autoagents_mistral_rs_py-0.4.0-cp39-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 b89d640958f5a16b496c92f20276dd19004c180fd39ac059e2acfe3585b1f02e
MD5 bea493ca08a7d54d78d5ef61ec94a1b6
BLAKE2b-256 94db89b27411e2983317a696faa619d19a13cdae615757039623aa2e0473e868

See more details on using hashes here.

Provenance

The following attestation bundles were made for autoagents_mistral_rs_py-0.4.0-cp39-abi3-manylinux_2_28_aarch64.whl:

Publisher: python-bindings.yml on liquidos-ai/AutoAgents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file autoagents_mistral_rs_py-0.4.0-cp39-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for autoagents_mistral_rs_py-0.4.0-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 cd7418b922d4ecb4f3ca7ccb8bb9be067b75827a31fbd32683bab6a3f2b435cc
MD5 76a11c5851c551ddb65a6fd273fc5f84
BLAKE2b-256 7d0e3d7ed898bcfb2c4128697bdfc20a533b0434f8dc78646a733a1d012f0d08

See more details on using hashes here.

Provenance

The following attestation bundles were made for autoagents_mistral_rs_py-0.4.0-cp39-abi3-macosx_11_0_arm64.whl:

Publisher: python-bindings.yml on liquidos-ai/AutoAgents

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page