AIFLUXON
Experimental Python SDK for the AIFLUXON in-process agent backend.
Python → PyO3 → aifluxon-api → runtime → providers / tools
Install
python -m pip install aifluxon
Requires CPython 3.11–3.14 on Windows 10/11 x86_64, Linux glibc x86_64, or Linux glibc aarch64. Wheels are ABI-specific (cp311–cp314), not abi3. Linux wheels target manylinux2014 / glibc 2.17 or newer. Alpine/musl, macOS, Windows ARM64, PyPy, and free-threaded CPython are not supported by 0.2.1 wheels. Installing a published wheel does not require Rust.
License: Apache-2.0.
Quick start
import asyncio
from aifluxon import Agent, ControlledProvider
async def main():
agent = Agent(provider=ControlledProvider(["Hello from AIFLUXON."]))
print((await agent.run("hello")).text)
asyncio.run(main())
Multimodal prompt:
from aifluxon import Agent, DeepSeek, ImageInput
agent = Agent(DeepSeek("deepseek-flash", api_key="...", api_mode="responses"))
result = await agent.run([
"Describe this image.",
ImageInput.from_file("./input.png"),
])
ImageInput also accepts public URLs, provider file IDs, bytes, and data URLs. Python tools can return ImageInput values for multimodal tool output.
For DeepSeek image-returning tools, select api_mode="responses"; Chat Completions supports user image inputs but not image tool outputs. The legacy deepseek-v4-flash-vision-exp name remains compatible. ImageInput.from_file_id() uses an existing provider file ID; it does not upload a file. The SDK supplies the image protocol and @tool bridge, while your application supplies and authorizes a view_image tool. See examples/view_image.py for a runnable example.
ControlledProvider is offline. Public providers: OpenAI, DeepSeek, Qwen, Kimi, Gemini, Codex, Custom. ChatGPT Web and DeepSeek Web are not included in this SDK.
Documentation: https://github.com/aifluxon/aifluxon/blob/main/docs/python/README.md
Build from source
This package is the Python binding. It depends only on aifluxon-api.
Windows PowerShell:
cd bindings/python
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install maturin pytest pytest-asyncio
maturin develop
python -c "import aifluxon; print(aifluxon.__version__)"
pytest
Linux:
cd bindings/python
python3 -m venv .venv
source .venv/bin/activate
python -m pip install maturin pytest pytest-asyncio
maturin develop
python -c "import aifluxon; print(aifluxon.__version__)"
pytest
1 maintainer
Metadata
1 maintainer
Release files for aifluxon 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 65.7 MB
Release files / aifluxon-0.2.1-cp314-cp314-win_amd64.whl
| Download URL | aifluxon-0.2.1-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 4.3 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
37a6129ee9ef98bf0582f46d43bc57320beb344612c5d04b0b8d91898f5f9d50
|
|
BLAKE2b-256 checksum How to use checksums |
262580613077478f854fabe116d6f0e71023109d4ce466256ce87bc1d302094e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / aifluxon-0.2.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aifluxon-0.2.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 6.0 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
5fa4a2b986c584749f626a0ebd674cc4b4caa519142c1f7f8af4557c9715cae3
|
|
BLAKE2b-256 checksum How to use checksums |
8891624df9379e6ee84f2162e2128d6322c1b960110382802c118672f4167655
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / aifluxon-0.2.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aifluxon-0.2.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 6.1 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
b42f354ee81d6603149ac58b7f1a39d3a4e7c1bd609506e4cc1f96851ad44ba0
|
|
BLAKE2b-256 checksum How to use checksums |
3c3bb3272ce5ff4a4b272c01a834e8ccd18e08b319642fe19fee0fcd61e4a3e4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / aifluxon-0.2.1-cp313-cp313-win_amd64.whl
| Download URL | aifluxon-0.2.1-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 4.3 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
afbaafbcf3c1fdc1d87c94505921cf002c17dc62cef95f2ac69ba1197b202719
|
|
BLAKE2b-256 checksum How to use checksums |
c7234d46e3cb2ffe0bb9e539f93f254d019eb6842149c0d3b370c21852f8022a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / aifluxon-0.2.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aifluxon-0.2.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 6.0 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
486f737a7b510afa44b907e82355de7548a416fe8240c955e6726973d26fc4d4
|
|
BLAKE2b-256 checksum How to use checksums |
6d1b5d7167fba0aa31bd3c07d0ef954da93c4b9b8a1c28026822842c6be08629
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / aifluxon-0.2.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aifluxon-0.2.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 6.1 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
8bfd39dcb3dbbd493b34ac03d31341144f956c5c1f16e2eb09fbabb6d7399ecd
|
|
BLAKE2b-256 checksum How to use checksums |
e36e8c37396fc38906d055175a0f2b688b4cb32cbffb346266f0d38a52069785
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / aifluxon-0.2.1-cp312-cp312-win_amd64.whl
| Download URL | aifluxon-0.2.1-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 4.3 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
b89b5aa8111035dc56d98a8f905c4921d25e0b6824c31b8a2078d9c715ae9a93
|
|
BLAKE2b-256 checksum How to use checksums |
a73bf4d9f4cea6a60e9b69daa71ecb1473bc9e174ccdf1e0ca4dc5738b6fb246
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / aifluxon-0.2.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aifluxon-0.2.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 6.0 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
f3af085450775adc41ef67f9258887090d777d05b4ae048f76b84da69e985ede
|
|
BLAKE2b-256 checksum How to use checksums |
cd42ea7bbe5bdcd78d48183bf230e3d600e2ff1b5f801bdb9ea3aa15e5a7e567
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / aifluxon-0.2.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aifluxon-0.2.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 6.1 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
f216703d668789f8340ee418b0668b152088dad90e088e9cf8063d1b87df58a4
|
|
BLAKE2b-256 checksum How to use checksums |
7178318d42e75050f0b23b5b44f360d3a73315363bf01311b1fedb09c75a7cb0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / aifluxon-0.2.1-cp311-cp311-win_amd64.whl
| Download URL | aifluxon-0.2.1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 4.3 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f657a9b2d20e5e11f741ac0cd7cb24ea0647949f0305ca4c08674ecfe74a828e
|
|
BLAKE2b-256 checksum How to use checksums |
600066bcd4473e45c3f811c314c897def7515abd19633d28a5afaabecddfdff7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / aifluxon-0.2.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aifluxon-0.2.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 6.0 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
9fa74bbb57aabd5904ffd12a5eaec305553f2df857e8adf8eb4d5bde21de7429
|
|
BLAKE2b-256 checksum How to use checksums |
c50244df554b4b1125728f0de6b7253db2ad07236e1e06c03cbf256280bf0407
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / aifluxon-0.2.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aifluxon-0.2.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 6.1 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
82d35a67cbdc69070256501365c5d723b71a587f2595ce6e26295de8d510e2e3
|
|
BLAKE2b-256 checksum How to use checksums |
923c439b38684a06b63eca4749edc02db6c6aded8cfa88ca8f461c99023c7737
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logSecurity for aifluxon 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 12 files in this release have been uploaded with provenance metadata.
Attestation for aifluxon-0.2.1-cp314-cp314-win_amd64.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
