nexora-tasks-sdk 1.0.0

Python SDK for Nexora Tasks — define, test, and deploy task workflows

Task Framework Python SDK

Python SDK for building, testing, and deploying tasks with the Task Framework.

Installation

pip install nexora-tasks-sdk

Quick Start

1. Create a new task

task init my-task --runtime python
cd my-task

2. Edit task.py

async def run(context):
    context.report_progress(0.0, "Starting...")

    inputs = context.get_inputs()
    # ... your logic ...

    context.report_progress(1.0, "Done")
    return [{"kind": "text", "text": "Result"}]

3. Run locally

task run

4. Deploy

task deploy --server https://tasks.example.com --key YOUR_ADMIN_KEY

CLI Commands

Command	Description
task init <name>	Scaffold a new task project
task run	Start a local dev server
task package -t . -o task.zip	Package task for deployment
task deploy -s URL -k KEY	Deploy to remote server
task status <thread_id> -s URL -k KEY	Check thread status
task list -s URL -k KEY	List deployed tasks

TaskContext API

The context object passed to your task function provides:

Inputs & Outputs

• context.get_inputs() — Returns list of input artifacts
• Return a list of output artifacts from your function

Progress Reporting

• context.report_progress(fraction, message) — Report progress (0.0 to 1.0)

Cooperative Control

• context.check_pause() — Blocks if task is paused, raises if cancelled
• context.is_paused() — Returns True if pause requested
• context.is_cancelled() — Returns True if cancellation requested

Artifacts

• context.store_artifact(data, filename, media_type) — Store output artifact
• context.get_artifact(artifact_id) — Retrieve an artifact

Configuration

• context.get_config(key) — Get a configuration/credential value

Task Definition (task.yaml)

name: my-task
version: 1.0.0
description: "What the task does"
entry_point: task:run
runtime: python                   # python | node

input_schemas:
  - ref: input_data
    kind: text
    required: true
    description: "Input description"

output_schemas:
  - kind: file
    media_type: application/pdf
    description: "Output description"

requirements:
  - name: API_KEY
    required: true
    description: "External API key"

Development

# Clone the monorepo
git clone https://github.com/Tessi-Wekey/tasks-platform.git
cd task-framework

# Install in development mode
uv sync

# Run SDK tests
uv run --package nexora-tasks-sdk pytest packages/sdk-python/tests/ -v

License

MIT