UnitySVC Customer SDK

unitysvc-py is the customer-facing Python SDK and usvc CLI for UnitySVC.

It wraps the customer-tagged backend API with a typed sync (Client) and async (AsyncClient) surface, plus a usvc command-line tool for day-to-day operations.

Early scaffolding

The customer API currently exposes a small set of endpoints (aliases, recurrent requests, secrets). The SDK tracks those today and will grow as the backend adds more.

No API key? Browse the catalog anyway

Client() with no api_key reads the public catalog — groups.list(), groups.services(name), and services.get(id). See the SDK Guide.

Quick links

• Getting Started — install, configure, first request
• CLI Reference — every usvc subcommand
• SDK Guide — usage patterns and code examples
• SDK Reference — auto-generated class and method docs

At a glance

from unitysvc import Client

client = Client.from_env()  # reads UNITYSVC_API_KEY + UNITYSVC_API_URL
secrets = client.secrets.list()
for s in secrets.data:
    print(s.name)

usvc secrets list
usvc secrets set openai-key --value sk-...
usvc aliases list
usvc recurrent-requests list

usvc groups list
usvc groups services llm
usvc services show <service-id>
usvc services enroll <service-id> --parameter api_key=sk-...
usvc services dispatch <service-id> --json '{"messages": [...]}'
usvc services schedule <service-id> --interval 300 --json '{...}'
usvc enrollments list
usvc resolve --path v1/chat/completions --routing-key '{"model": "gpt-4"}'