eolaswork 0.1.1

Official Python SDK for the EolasWork agentic platform

eolaswork

Official Python SDK for the EolasWork agentic platform.

Install

pip install eolaswork

Python 3.11+. Sync + async clients ship together.

Two ways to run agents

Use case	Method	What it does
Chat with file attachments + history	client.tasks.send_message(task_id, ...)	Creates a turn + run bound to an existing task; agent sees uploaded files + prior messages.
Fire-and-forget standalone agent	client.runs.create(...)	Independent run; no task / file context. Good for cron-style jobs.

The model used for each run is fixed by the chosen role or team's manifest (default_model). There is no per-call model override today; if your tenant has multiple models wired up, change the role's manifest to switch.

Quickstart: chat with attachments

from eolaswork import Client

client = Client(api_key="nxa_...")        # or set EOLASWORK_API_KEY

# 1. Discover what's available
me     = client.account.whoami()
roles  = client.roles.list()              # pick a role.slug for the run
models = client.models.list()             # each Model has .id (UUID), .display_name, .provider

# 2. Create a task (the conversation the agent operates inside)
task = client.tasks.create(title="Q2 board prep")

# 3. Attach files to the task
client.files.upload(task.id, "./Q2_sales.xlsx")

# 4. Send the message - this creates a turn + run on the task and
#    returns the run object. The agent sees the attached files +
#    full conversation history.
run = client.tasks.send_message(
    task.id,
    prompt="Build a board-ready summary from the Excel I attached.",
    role="research-analyst",                       # role.slug from client.roles.list()
    skills=["xlsx-reader"],
)

# 5. Wait for the run to finish (or stream events live)
final = client.runs.wait(run.id, timeout=300)
print(final.status, final.output)

# Streaming alternative:
for ev in client.runs.stream(run.id):
    print(ev.kind, ev.payload)

Quickstart: standalone run (no task / files)

run = client.runs.create(
    prompt="Summarise today's INGEST team Slack channel.",
    role="research-analyst",                       # role.slug
    webhook_url="https://my-app.example.com/eolaswork/hook",  # optional
)

# Three ways to handle completion:
final = client.runs.wait(run.id, timeout=300)               # blocks
# OR live SSE:
for ev in client.runs.stream(run.id): print(ev.kind, ev.payload)
# OR don't wait - your webhook receiver gets the HMAC-signed POST.

print(final.status, final.output)

Async

import asyncio
from eolaswork import AsyncClient

async def main():
    async with AsyncClient(api_key="nxa_...") as client:
        task = await client.tasks.create(title="async run")
        run = await client.tasks.send_message(
            task.id, prompt="hello", role="research-analyst",
        )
        async for ev in client.runs.astream(run.id):
            print(ev)

asyncio.run(main())

Webhook receiver

from eolaswork.webhooks import verify_signature

@app.post("/eolaswork/hook")
def hook(request):
    payload = verify_signature(
        raw_body=request.body,
        signature_header=request.headers["X-EolasWork-Signature"],
        secret=os.environ["EOLASWORK_WEBHOOK_SECRET"],
    )
    print(payload.run_id, payload.status, payload.output)
    return "", 204

Configuration

Env var	Default	Meaning
EOLASWORK_API_KEY	required	Bearer key (create at /settings/api-keys)
EOLASWORK_BASE_URL	https://nexa.aihq.ie	Backend host (override for self-hosted)

Explicit constructor args win over env vars:

client = Client(api_key="...", base_url="https://eolaswork.your-co.com",
                timeout=120.0, max_retries=5)

Resource surface

Resource	What it does
client.account	whoami, instructions, preferences, artifacts
client.api_keys	list / create / revoke programmatic keys
client.tasks	conversations CRUD + send_message
client.runs	create / retrieve / list / cancel / wait / stream / approve / deny
client.files	upload / list / download / delete / to_pdf
client.roles	catalogue + file content (read-only)
client.teams	catalogue + file content (read-only)
client.skills	catalogue + file content (read-only)
client.models	LLM model catalogue + providers
client.followups	cross-conversation action items
client.memory	user-level KV memory

Async variants share the exact same surface on AsyncClient -- every method is awaitable.

License

MIT.