Quickstart

Generate a production-ready .NET SDK from any OpenAPI specification in three steps.

Prerequisites

.NET SDK 8.0+ installed
An OpenAPI 3.0 or 3.1 specification (URL or local file)

Step 1: Install the CLI

dotnet tool install --global autosdk.cli --prerelease

Verify the installation:

autosdk --version

Step 2: Generate Your SDK

autosdk generate https://petstore3.swagger.io/api/v3/openapi.json \
  --namespace MyCompany.PetStore \
  --clientClassName PetStoreClient \
  --output Generated

This downloads the OpenAPI spec, processes it through AutoSDK's generation pipeline, and outputs fully typed C# files into the Generated/ directory.

Step 3: Build and Use

Create a new console project and add the generated files:

dotnet new console -n PetStoreDemo
cp -r Generated/ PetStoreDemo/
cd PetStoreDemo
dotnet build

Use the generated client:

using MyCompany.PetStore;

using var client = new PetStoreClient();
var pets = await client.FindPetsByStatusAsync(
    status: FindPetsByStatusStatus.Available);

foreach (var pet in pets)
{
    Console.WriteLine($"{pet.Name} ({pet.Status})");
}

Next Steps

Installation — Set up the source generator for compile-time generation
First SDK — End-to-end walkthrough building a real SDK project
CLI Commands — Full CLI reference