Introduction

Soxom is a managed SDK platform. You give it an OpenAPI specification, and Soxom produces the source code for idiomatic, publishable client libraries in multiple languages — then keeps them in sync as your API evolves.

What Soxom does

You write your API definition once. Soxom turns it into production-quality SDKs with built-in support for pagination, retries, timeouts, streaming, and authentication. The generated code lives in Soxom-managed GitHub repositories, versioned and ready to publish to npm, PyPI, Maven Central, or other registries.

There is nothing to install locally. Soxom runs in the cloud and integrates with your GitHub account through the Soxom GitHub App.

How it fits together

You own one repository — your Config Repository — containing your openapi.yaml and a soxom.yaml that tells Soxom how to shape each SDK. Every push to that repo triggers a build. For each SDK target, Soxom maintains a Staging Repository and a Production Repository:

• Code is regenerated on a codegen/next branch in the Staging Repository.
• Custom hand-written code is merged in on extended/next, then onto next.
• Soxom opens a staging-release PR that bumps the version using Conventional Commits.
• Merging the staging PR opens a production-release PR.
• Merging the production PR cuts a git tag and optionally publishes the package to a registry.

Key features

Multi-language

Generate idiomatic SDKs for TypeScript, Python, and Java from a single OpenAPI spec. Go is in preview.

Type-safe by default

Full type generation including unions, enums, discriminated types, and nested resources.

GitHub-native

Config lives in your repo. Generated SDKs live in Soxom-managed staging and production repos you can read, fork, and PR against.

Production-grade clients

Built-in pagination, retries with backoff, configurable timeouts, SSE streaming, and pluggable auth.

Supported languages

Language	Status
TypeScript	Supported
Python	Supported
Java	Supported
Go	Preview

OpenAPI support

Format	Supported
OpenAPI 3.1	Yes — feature matrix
OpenAPI 3.0	Yes
OpenAPI 2.0 (Swagger)	No

Next steps

• Sign up & connect GitHub — get an account and authorize the GitHub App.
• Quick Start — go from zero to a tagged release.
• How Soxom works — the full Config → Staging → Production flow.
• Core Concepts — the vocabulary used throughout these docs.