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

Project links

Data verified by PyPI on Jul 8, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for saivishwak from gravatar.com saivishwak

Credits

Author/Maintainer: Sai Vishwak Korimerla

GitHub Statistics

Data verified by PyPI on Jul 8, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License, MIT License (MIT OR Apache-2.0)

Requires

Python >=3.9

Provides Extra

guardrails llamacpp llamacpp-cuda llamacpp-metal llamacpp-vulkan mistralrs mistralrs-cuda mistralrs-metal

Classifiers

Report project as malware

Download files

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

Source Distribution

autoagents_py-0.4.0.tar.gz (473.8 kB view details)

Uploaded Source

Built Distributions

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

autoagents_py-0.4.0-cp39-abi3-manylinux_2_28_x86_64.whl (8.8 MB view details)

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

autoagents_py-0.4.0-cp39-abi3-manylinux_2_28_aarch64.whl (8.4 MB view details)

Uploaded CPython 3.9+manylinux: glibc 2.28+ ARM64

autoagents_py-0.4.0-cp39-abi3-macosx_11_0_arm64.whl (8.0 MB view details)

Uploaded CPython 3.9+macOS 11.0+ ARM64

File details

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

File metadata

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

File hashes

Hashes for autoagents_py-0.4.0.tar.gz
Algorithm Hash digest
SHA256 c3025471c6ea23537831059bce57e61913b9805a2b17ca09eefe45dafaa6cb7b
MD5 6b45faa91926aba0f73afb5dc370e349
BLAKE2b-256 2491ec8c044ceb5a79e11584b8a75331672a4964161a6f8b723148cb9f801c5b

See more details on using hashes here.

Provenance

The following attestation bundles were made for autoagents_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_py-0.4.0-cp39-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for autoagents_py-0.4.0-cp39-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a0438a46d3215ad5728e41ce9220f12599119dee0d980deedb0daba91eeab065
MD5 8ae6949f7e53cf852dbd7595bbb5239b
BLAKE2b-256 799b6e8ce4112ece3da240e156c94089e26a2de28f6ad5cb3a47aae248e8aa26

See more details on using hashes here.

Provenance

The following attestation bundles were made for autoagents_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_py-0.4.0-cp39-abi3-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for autoagents_py-0.4.0-cp39-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 cc19d7fbf1a11df9a6fb26e30793243f9ab593788fc9a0b089717d6c8753aeee
MD5 0df061bbeb307fb8a31273a26a88f6a0
BLAKE2b-256 5d0caf0fba5be62b63f90c069a685d1a1622a2f3d29185da090bb7a5aa97dd85

See more details on using hashes here.

Provenance

The following attestation bundles were made for autoagents_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_py-0.4.0-cp39-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for autoagents_py-0.4.0-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 dd22084c4a2f00fa6605c6851a245ca4af2e91918a363cd5d87d9f1521128c2a
MD5 6668c51a3ecdee18605ddd4ab617507b
BLAKE2b-256 a53d29b84cb6cff406b2a5a746ebc1e293bba6cd492ab7903d5cabe78a0681e9

See more details on using hashes here.

Provenance

The following attestation bundles were made for autoagents_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 Pingdom Monitoring Sentry Error logging StatusPage Status page