How-to

Generate an SDK from OpenAPI without the glue work.

Upload an OpenAPI 3.x spec and Sourced generates a TypeScript and Python SDK preview, compares it to your live SDK, and gives you a launch report — before any package is published.

Unlimited previews. No credit card required.

  • InputOpenAPI spec
  • LanguagesTS + Python
  • DocsPreview + llms.txt
  • ReleaseLaunch checks

01Details

Four steps

01

Upload OpenAPI 3.0 or 3.1 (yaml or json) — Sourced infers a starter generator config from the spec.

02

Sourced emits TypeScript and Python SDK previews with package.json, pyproject.toml, README, and a generation report.

03

If you supply a current SDK, Sourced diffs the public surface — methods, error classes, pagination, examples — and flags shapes to review.

04

Approve the report and Sourced prepares repo-sync, registry readiness, and docs-hosting readiness checks from the same spec.

02Outputs

What's in the generated SDK

01

Typed client class derived from your spec's operations and schemas.

02

Idiomatic method names per language (camelCase TS, snake_case Python).

03

Error classes for the standard HTTP statuses.

04

Auth options derived from your security schemes and env-var conventions.

05

README with a runnable client snippet using your spec's example endpoint.

03Details

Why Sourced is different from raw generators

01

Raw OpenAPI Generator templates produce code; Sourced adds the compatibility report and docs preview.

02

Sourced reads stainless.yml if you have one, so package names and existing customer-facing imports survive the migration.

03

Generation, docs, and publishing readiness stay in one workflow rather than three separate tools.

·Example output

A generation run shows the SDK artifact shape.

TypeScript4 files

A local fixture run produced package.json, tsconfig.json, README.md, and src/index.ts.

Python13 files

A local fixture run produced pyproject.toml, README.md, typed package files, sync client, async client, errors, models, and utilities.

Reports2 SDK reports

TypeScript and Python reports record package name, client name, base URL, resources, methods, skipped methods, and files.

Dashboard15 E2E flows

Browser tests cover public pages, upload validation, signed-out blocking, generated links, failed runs, expired artifacts, publish-ready state, billing state, and the local HTTP worker artifact path.

Example Sourced output for this page
ExampleWhy it mattersCurrent result
TypeScript SDK reportGenerated from OpenAPI plus config through the worker pipeline.Package smoke, client APIAPI, 1 resource, 1 method, 0 skipped methods.
Python SDK reportGenerated from the same input and includes sync plus async runtime surfaces.Package smoke_api, clients APIAPI and AsyncAPIAPI, 13 emitted package files.
Run-state browser coverageThe dashboard is tested against the states users actually see after generation.Generated artifacts, failed callbacks, expired artifacts, publish-ready releases, signed-out blocking, and billing readiness are covered.