eigenpal
Trigger and inspect Eigenpal automations from Python.
Install
pip install eigenpal
Requires Python 3.10+. Get an API key at studio.eigenpal.com -> Settings -> API Keys.
Quick Start
import os
from pathlib import Path
from eigenpal import EigenpalClient
client = EigenpalClient(api_key=os.environ["EIGENPAL_API_KEY"])
result = client.run_and_wait(
"workflows.extract-invoice",
input={"contract_document": Path("contract.pdf")},
)
print(result.finished, result.output)
target is always typed: workflows.<slug> or agents.<slug>. That keeps workflow and agent slugs unambiguous.
Automations
Workflows and agents are exposed as automations.
listing = client.automations.list(search="invoice")
automation = client.automations.get("workflows.extract-invoice")
versions = client.automations.versions("workflows.extract-invoice")
triggers = client.automations.triggers("workflows.extract-invoice")
Runs
started = client.run("agents.invoice-agent", input={"invoice": Path("invoice.pdf")})
run = client.runs.get(started.id, expand=["usage", "execution"])
usage = client.runs.usage(started.id)
steps = client.runs.steps(started.id)
events = client.runs.events(started.id)
trace = client.runs.trace.get(started.id)
client.runs.cancel(started.id)
client.rerun(started.id, wait_for_completion=60)
List calls use the same run API for workflows, agents, manual runs, and eval runs:
recent_failures = client.runs.list(
type="workflow",
status="failed,cancelled",
limit=50,
)
Files And Artifacts
Use client.files for reusable upload-first blobs. When referenced by a run input, Eigenpal snapshots the file into run-scoped artifacts.
uploaded = client.files.upload(Path("contract.pdf"))
started = client.run(
"workflows.extract-invoice",
input={"contract_document": {"$fileId": uploaded.id}},
)
artifacts = client.runs.artifacts.list(started.id)
content = client.runs.artifacts.download(started.id, artifacts.artifacts[0].path)
You can also pass a Path, file handle, or {"content": bytes, "filename": str, "mime_type": str} directly to client.run; the SDK sends multipart form data automatically. Durable run inputs and dataset examples store scoped {"$file": "input/..."} artifact refs after ingestion.
Errors
Every non-2xx response raises a typed subclass of EigenpalError:
| HTTP | Class |
|---|---|
| 400 | EigenpalValidationError |
| 401 | EigenpalAuthError |
| 403 | EigenpalForbiddenError |
| 404 | EigenpalNotFoundError |
| 429 | EigenpalRateLimitError |
| 5xx | EigenpalServerError |
| timeout | EigenpalTimeoutError |
Reference
| Topic | What is in it |
|---|---|
| Automations | List, inspect, versions, triggers. |
| Runs | Start, poll, cancel, rerun, usage, steps, events, traces, reviews. |
| File inputs | Multipart upload from Path, file handle, or bytes. |
| Errors | Typed exceptions, retries, request ids. |
| Configuration | API key, base_url, timeouts, headers. |
| Full API reference | Every method, generated from OpenAPI. |
License
Apache-2.0.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file eigenpal-0.10.16.tar.gz.
File metadata
- Download URL: eigenpal-0.10.16.tar.gz
- Upload date:
- Size: 81.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3987f93e5b0b786523607909daa367633e98fce2564aac57064e6a9e4d0f29e2
|
|
| MD5 |
facaf67a84cdb7b2d120d5fac15abd75
|
|
| BLAKE2b-256 |
0ae3b27f22ac75d33f1b26f3c90afefb232101dacf1c50ba9d8bd3a058060022
|
Provenance
The following attestation bundles were made for eigenpal-0.10.16.tar.gz:
Publisher:
release.yml on eigenpal/eigenpal
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
eigenpal-0.10.16.tar.gz -
Subject digest:
3987f93e5b0b786523607909daa367633e98fce2564aac57064e6a9e4d0f29e2 - Sigstore transparency entry: 2098261738
- Sigstore integration time:
-
Permalink:
eigenpal/eigenpal@b1f0bca747e29f24ab788cc946cb61f0e8f9f84b -
Branch / Tag:
refs/heads/main - Owner: https://github.com/eigenpal
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
self-hosted -
Publication workflow:
release.yml@b1f0bca747e29f24ab788cc946cb61f0e8f9f84b -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file eigenpal-0.10.16-py3-none-any.whl.
File metadata
- Download URL: eigenpal-0.10.16-py3-none-any.whl
- Upload date:
- Size: 250.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
951665218866091def781ed9a79eb06d7d61a76aae2cbea40d258576ae5940e7
|
|
| MD5 |
0807b7cf478e41d302efe594f2c0754e
|
|
| BLAKE2b-256 |
5bcb6467c81d314528989277cca4ed65bbb4ec3b3a946e0a6ce81274d9bdb622
|
Provenance
The following attestation bundles were made for eigenpal-0.10.16-py3-none-any.whl:
Publisher:
release.yml on eigenpal/eigenpal
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
eigenpal-0.10.16-py3-none-any.whl -
Subject digest:
951665218866091def781ed9a79eb06d7d61a76aae2cbea40d258576ae5940e7 - Sigstore transparency entry: 2098262121
- Sigstore integration time:
-
Permalink:
eigenpal/eigenpal@b1f0bca747e29f24ab788cc946cb61f0e8f9f84b -
Branch / Tag:
refs/heads/main - Owner: https://github.com/eigenpal
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
self-hosted -
Publication workflow:
release.yml@b1f0bca747e29f24ab788cc946cb61f0e8f9f84b -
Trigger Event:
workflow_dispatch
-
Statement type:
