# 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.

[View docs →](/content/docs/index.html)

Available now

- Public API V1
- Python SDK
- Webhooks
- Real-time streaming
- File attachments
- Artifact exports

## 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
```

## 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.

### Endpoints

- `GET/v1/projects`: List all projects
- `POST/v1/projects/{id}/tasks`: Run an agent task
- `GET/v1/projects/{id}/threads`: List execution history
- `POST/v1/files/upload-url`: Get presigned upload URL
- `GET/v1/artifacts`: List all artifacts
- `POST/v1/artifacts/{id}/export`: Export artifact result
- `POST/v1/triggers`: Register a webhook trigger
- `DEL/v1/projects/{id}/tasks/{task_id}`: Cancel a running task

## 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.

## 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

## What's on the roadmap.

### Soon

#### n8n Connector

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

#### Zapier Integration

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

#### Make.com Connector

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

#### Agent Hub

Publish, distribute, and monetize 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 dashboard](/content/register/index.html) [Contact us](mailto:support@starnustech.com)