Zelos developer portal

Everything needed to drive Zelos from code: the API and its OpenAPI specification, OAuth 2.0 authentication, the CLI, the SDKs for Python, Rust, and Go, and the machine-readable index this site publishes for agents.

Zelos API

The Zelos cloud API is the same OAuth-authenticated REST surface the Zelos CLI and desktop app use. It manages organizations, traces, notebooks, layouts, and tags.

Zelos OpenAPI specification

OpenAPI 3.1 document covering every documented operation, with an operation id, typed parameters, and response schemas on each one.

/openapi.json

Zelos API health check

Unauthenticated liveness endpoint. Returns the running console version and a timestamp.

GET /api/health

Zelos API documentation

Task-oriented guides for the cloud console, sharing traces, publishing notebooks, storage, and billing.

docs.zeloscloud.io/cloud

Zelos authentication

Zelos uses OAuth 2.0. Terminals and agents use the device authorization grant (RFC 8628), so no browser redirect back to localhost is needed. Clients can register themselves.

Zelos OpenID Connect discovery

The issuer metadata document. Lists the authorization, token, registration, introspection, and revocation endpoints.

/.well-known/openid-configuration

Zelos device authorization endpoint

Start a device flow, show the user code, then poll the token endpoint with the device_code grant.

POST /api/auth/device/code

Zelos CLI login

The `zelos login` command runs the same device flow and stores the token in your system keyring.

zelos login

Zelos self-serve client registration

Register your own OAuth client by POSTing client metadata. No form, no sales call, no waiting: an agent can obtain its own credentials unattended.

POST /api/auth/oauth2/register

Zelos CLI

The Zelos CLI drives the app, the agent, and the cloud from a terminal or from CI. It installs to ~/.zelos/bin and needs no elevated permissions.

Install the Zelos CLI

One command on macOS, Linux, and Windows, plus direct binary downloads for every supported target.

curl -fsSL https://release.zeloscloud.io/cli/install.sh | bash

Zelos CLI reference

Every command, subcommand, and flag: status, login, actions, agent, extensions, layouts, live, trace, update.

docs.zeloscloud.io/reference/cli

Zelos SDKs

Stream typed, unit-aware data out of the code you already run. Schemas, units, and metadata travel with the data, so the app and the traces describe themselves.

Zelos Python SDK

pip install zelos-sdk. Includes the pytest plugin and the trace reader.

pypi.org/project/zelos-sdk

Zelos Rust SDK

cargo add zelos. The same trace format the agent and the app read.

crates.io/crates/zelos

Zelos Go SDK

go get github.com/zeloscloud/zelos/go.

pkg.go.dev/github.com/zeloscloud/zelos/go

Zelos SDK documentation

Quick start, core concepts, and how-to guides for streaming, schemas, recording, filtering, and testing.

docs.zeloscloud.io/sdk

Zelos resources for agents

Fixed paths an automated client can fetch without scraping. Every page on this site also returns markdown to a request that sends Accept: text/markdown.

Reading this site as markdown

Every page here serves a markdown representation from the same URL. Ask for it with an Accept header, or append .md to the path.

curl -H "Accept: text/markdown" https://zeloscloud.io/developers
curl https://zeloscloud.io/developers.md