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.

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"}'