Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Inferact

Python client and inferact command-line tool for the Inferact management API: list and inspect deployments, create and approve previews, follow operations, and talk to a running deployment through an OpenAI-compatible inference client.

Status

This is a pre-release. Commands, Python APIs and output formats may change between versions.

Install

Requires Python 3.11 or later.

pip install --pre inferact                         # Python client and CLI
pip install --pre 'inferact[inference]'            # adds the OpenAI-compatible inference client
uv tool install --prerelease allow inferact        # CLI in its own environment
pipx install --pip-args=--pre inferact             # same, with pipx

CLI

inferact login --base-url https://<install>
inferact open                                      # the portal in your browser
inferact deployments list
inferact deployments get ID
inferact config list                               # every setting and where it came from
curl -H "Authorization: Bearer $(inferact auth token)" https://<install>/api/v1/auth/me

Run inferact --help for every command. Add --json for machine-readable output. Settings come from flags, then INFERACT_* environment variables, then config.json (inferact config set KEY VALUE), then the saved profile.

Python

import os

from inferact import Inferact

# Settings resolve like the CLI: INFERACT_ACCESS_TOKEN and INFERACT_BASE_URL when the
# token is set, else the sign-in saved by `inferact login`.
with Inferact() as dock:
    for deployment in dock.deployments.list():
        print(deployment.id, deployment.name, deployment.status)

    d = dock.deployments.get(os.environ["DEPLOYMENT_ID"])
    # Requires the inference extra and INFERACT_INFERENCE_API_KEY.
    with d.client() as inference:
        response = inference.chat.completions.create(
            model=d.model_id,
            messages=[{"role": "user", "content": "Hello"}],
        )
        print(response.choices[0].message.content)

Contributing

See sdk/python/docs/DEVELOPMENT.md in the repository for the local workflow, the full CLI and SDK contract, and release steps.

License

Apache License 2.0. See the LICENSE and NOTICE files shipped with the package.

Metadata

Release files for inferact 0.1.0a2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for inferact 0.1.0a2
File Size Uploaded Provenance Actions
inferact-0.1.0a2.tar.gz 119.9 kB With provenance Details for inferact-0.1.0a2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for inferact 0.1.0a2
File Interpreter ABI Platform Actions
inferact-0.1.0a2-py3-none-any.whl Python 3 none any Details for inferact-0.1.0a2-py3-none-any.whl

Total release size: 284.1 kB

Release files / inferact-0.1.0a2.tar.gz

Download URL inferact-0.1.0a2.tar.gz
Size 119.9 kB
Tags Source
SHA-256 checksum
How to use checksums
7e3459b0b488baf1e87cb9db7a03bd0e707a53e9a96c1bcc21018b82d3dd4666
BLAKE2b-256 checksum
How to use checksums
3645796caea0124371d4dfef2d2ab4dac26fd76f04c71c04e6956d49d7ea9d4b
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 27, 2026.

Transparency log

Release files / inferact-0.1.0a2-py3-none-any.whl

Download URL inferact-0.1.0a2-py3-none-any.whl
Size 164.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
030445a9fa8c1edf9b069b6864e043fafd53081c1918118b4848c2f069481963
BLAKE2b-256 checksum
How to use checksums
3ee606ff9e8d805b15f903893072061510abd05d56de9ddbe17f368414d52164
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 27, 2026.

Transparency log

Security for inferact 0.1.0a2

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

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for inferact-0.1.0a2.tar.gz

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 27, 2026.

Transparency log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page