Skip to Content
Get started

Quickstart

Create an agent, then reach your Sunport from code, Pi and a local agent.

At the end you have an agent. Your code, Pi and your coding agent all use your Sunport.

You need to be an administrator, and Pi and a coding agent such as Claude Code on your computer. Some free trial Sunports can't create agent VMs; there, the New agent page says so.

Say hello to Clem

Open Chat. If a tour opens, choose Skip.

Choose What can you do?

Clem, your Sunport's AI admin, answers.

Create an agent

Open Agents and choose New agent.

Under Assistants, choose OpenClaw. Keep the suggested work and size.

In the bar at the bottom, rename it to Research and choose Create agent.

When it's done, the window says “Research” is your first agent!

Ask it something

Choose Open chat and send:

Suggest three names for a team newsletter.

Research answers in the chat.

Create a model API key

Open API. Under Model API keys, choose Create key.

Type the Name quickstart, keep All models, and choose Create key.

Choose Copy key, note the Base URL, and choose Done.

The key is listed as Active.

Call a model from your code

Run this with your Base URL, key, and a model from Models:

curl BASE_URL/chat/completions \
  -H 'Authorization: Bearer MODEL_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"model":"MODEL","messages":[{"role":"user","content":"Hello"}]}'

The answer is in choices[0].message.content. Examples, on API, shows this request with each model's exact ID.

Open Requests. Your call is listed with its model and cost.

Use your models in Pi

Install the OpenOrange provider for Pi:

pi install git:github.com/2bb-dev/pi-openorange-provider

In Pi, type /login, choose Sign in with an API key, then OpenOrange.

Enter your Sunport's address, as your browser shows it, and your model key.

Pi says how many models are available. Type /model to pick one.

Create an agent API key

Open API. Under Agent API keys, choose Create key.

Type the Name quickstart. Under Agents, choose Research.

Choose Create key, then Copy key and Done.

The key is listed as Active.

Message the agent from your app

Run this with the agent key. SUNPORT is the address your browser shows, such as https://acme.openorange.ai:

curl -s SUNPORT/api/v1/agents/research/responses \
  -H 'Authorization: Bearer AGENT_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"input":"Hi! Reply in one sentence."}'

research is the agent's ID. Research's answer is in message.content, and thread.id continues the chat.

Install oo

On your computer, run:

curl -fsSL SUNPORT/oo | sh

It installs oo and gives your coding agents the openorange skill.

Sign in with oo

oo login --sunport SUNPORT

Approve the code in the browser window it opens.

oo prints your Sunport's name and address.

Give your coding agent the skill

oo skill install

oo prints each agent tool's skill path, such as Claude Code's or Codex's.

Ask your coding agent

Open your coding agent, such as Claude Code, and send:

List the agents in my Sunport with oo.

It runs oo agents list and names Research.

Next

On this page