engini

Agent-first Python SDK for the Engini Public API.

Pre-release. The public surface is defined; behavior ships in upcoming alphas. Install with pip install --pre engini.

from engini import Engini

client = Engini(token="...")                      # or ENGINI_API_TOKEN env var
tools = client.tools.get(search="create invoice", toolkits=["SAP"])
openai_tools = client.provider.wrap_tools(tools)  # plain OpenAI tool-JSON dicts

Command-line interface

The package ships an engini command — a machine-first CLI over the same surface, with TTY-aware output and --json / --schema on every command. Its dependencies are an opt-in extra, so install the cli extra to use it:

pip install --pre 'engini[cli]'

engini --help              # auth · tools · connections · connect
engini --version

Authenticate by pasting a dashboard-minted Engini API key (the primary path):

engini auth login --api-key eng_…   # stored in the active profile's config
engini auth status                  # shows auth_kind: api-key, masked key

The key is sent in the x-api-key header; the company is bound to the key, so no company token is needed. Two-token JWT auth (engini auth login --api-token <jwt> [--company-token <id>]) remains as a fallback. Set ENGINI_API_KEY to override per-invocation.

Profiles let you keep separate logins (e.g. one per company). The global --profile flag selects which one a command uses; default when omitted:

engini --profile staging auth login --api-key eng_… --api-url https://staging…/api
engini auth profile list                              # show profiles + active
engini auth profile use staging                       # switch the active profile
engini auth profile rename staging stg
engini auth profile remove stg                        # prompts unless --force
engini auth profile edit                              # open config.toml in $EDITOR

--api-url points a profile at a non-default API host (staging / self-hosted); engini auth profile edit opens the config file in $VISUAL/$EDITOR and re-validates it on save. Logging in over a profile that already has credentials prompts for confirmation (or pass --force); non-interactive runs must pass --force.

Scaffold. The command tree, output conventions, TOML config/profiles, and credential resolution are in place; commands that call the API are stubbed (they exit non-zero with a "not yet implemented" message) until an upcoming release.

Built on the autogenerated engini-client REST client. Source: https://github.com/engini/engini-sdk.

Download files

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

Source Distribution

engini-0.5.0.tar.gz (47.5 kB view details)

Uploaded Jun 17, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

engini-0.5.0-py3-none-any.whl (44.7 kB view details)

Uploaded Jun 17, 2026 Python 3

File details

Details for the file engini-0.5.0.tar.gz.

File metadata

Download URL: engini-0.5.0.tar.gz
Upload date: Jun 17, 2026
Size: 47.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for engini-0.5.0.tar.gz
Algorithm	Hash digest
SHA256	`35f96a2e5cf39f4e2aaeb69c1a12900fa21115e1ec5da3a4e6c7d5db1fd56b37`
MD5	`96be92e37e8334f04a350066d383ec32`
BLAKE2b-256	`10a724f51297d66474735afacef4f3cd76fbd412f69c5c23b9985390a3cc4bc7`

See more details on using hashes here.

Provenance

The following attestation bundles were made for engini-0.5.0.tar.gz:

Publisher: release-python.yml on engini/engini-sdk

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: engini-0.5.0.tar.gz
- Subject digest: 35f96a2e5cf39f4e2aaeb69c1a12900fa21115e1ec5da3a4e6c7d5db1fd56b37
- Sigstore transparency entry: 1847154906
- Sigstore integration time: Jun 17, 2026
Source repository:
- Permalink: engini/engini-sdk@1bf4f84f47e944476bd214e41b193b40688aa2f1
- Branch / Tag: refs/tags/py-sdk-v0.5.0
- Owner: https://github.com/engini
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-python.yml@1bf4f84f47e944476bd214e41b193b40688aa2f1
- Trigger Event: release