Now live

Build with
Starnus.

Integrate Starnus into your own pipelines and workflows using our Public API V1 and Python SDK. Trigger AI agents, stream results in real time, manage files and artifacts — all programmatically.

Available now
Public API V1
Python SDK
Webhooks
Real-time streaming
File attachments
Artifact exports
Quick start

Up and running
in minutes.

01 — Install the SDK
pip install starnus
02 — Run your first execution
import starnus

client = starnus.Starnus(
    api_key="sk_live_your_api_key")

# List your projects
projects = client.projects.list()

# Run an execution and stream
execution = client.executions.create(
    project_id=projects[0].id,
    prompt="Summarise the report.")

for event in execution.stream():
    if event.type == "result":
        print(event.message)
        break
API Reference

REST + WebSocket.
50+ endpoints.

The Starnus Public API covers projects, tasks, files, artifacts, integrations, billing, and real-time streaming — 50+ endpoints in total. All responses are JSON. Authenticate with a Bearer API key.

View full documentation →
GET/v1/projectsList all projects
POST/v1/projects/{id}/tasksRun an agent task
GET/v1/projects/{id}/threadsList execution history
POST/v1/files/upload-urlGet presigned upload URL
GET/v1/artifactsList all artifacts
POST/v1/artifacts/{id}/exportExport artifact result
POST/v1/triggersRegister a webhook trigger
DEL/v1/projects/{id}/tasks/{task_id}Cancel a running task
Capabilities

What you can build.

Trigger agents programmatically

Fire any Starnus agent from your own backend, CI/CD pipeline, or scheduled job via REST or SDK.

Stream results in real time

Subscribe to WebSocket execution events and surface agent updates live in your own UI.

Attach files & export artifacts

Upload PDFs, CSVs, and images as context. Export structured artifacts from any execution.

Webhook triggers

Register webhooks to fire Starnus executions from external events — CRM updates, form submissions, Slack messages.

Embed in your product

Build Starnus capabilities directly into your SaaS, internal tools, or client-facing workflows.

Secure by default

All API requests authenticated via Bearer key. Scoped permissions per project. Full audit logging.

Agent Hub

Build agents.
Deploy them.
Start earning.

Developers will be able to build and deploy their own AI agents on the Starnus Hub. Whether you're using LangChain, CrewAI, AutoGen, or vanilla Python, our SDK lets you adapt your existing agent code with just a few lines.

Coming soon
Deploy directly to Starnus from any Python agent framework
Set your own pricing per execution or per month
We handle billing, infrastructure, and distribution
Users discover and integrate your agents into their workflows
Compatible with LangChain, CrewAI, AutoGen, and vanilla Python
Coming next

What's on the roadmap.

Soon

n8n Connector

Native n8n node to trigger Starnus agents inside your automation workflows.

Soon

Zapier Integration

Connect Starnus to 6,000+ apps via Zapier. No code required.

Soon

Make.com Connector

Full Make.com module for building visual automation scenarios with Starnus agents.

Soon

Agent Hub

Publish, distribute, and monetise your own AI agents on the Starnus marketplace.

Start building
in minutes.

Create a free account, generate an API key in the developer dashboard, and start integrating Starnus into your workflows today.

Open dashboardContact us