TypeSpec is a language for describing cloud service APIs and generating other API description languages, client and service code, documentation, and other assets.
This repository adds common Azure-specific TypeSpec libraries to the TypeSpec core that is pulled in as a git submodule.
You can try TypeSpec on the web without installing anything. TypeSpec playground for Azure services
- To use these libraries, install Node.js (24 LTS or later) and ensure
you can run
node --versionfrom a command prompt. - To develop this repository, install and activate
mise. From the repository root,
run
mise installto install the development tools defined bymise.tomlandmise.lock. See the contributing guide for the complete setup.
For TypeSpec language documentation, see https://typespec.io/docs.
If you are team working on Azure, see TypeSpec Azure development documentation https://azure.github.io/typespec-azure. You should pre-install as well @azure-tools/typespec-azure-core to define Azure resources, and @azure-tools/typespec-autorest to export in Swagger:
pnpm add @typespec/rest @typespec/openapi3 @azure-tools/typespec-azure-core @azure-tools/typespec-autorest
If you plan to use the output openapi with autorest or any of the azure sdk tooling you should use typespec-autorest, the openapi3 emitter is not going to have any of the ms extensions (pageable, lro, client name, etc.) and so it will be losing information.
Information on using TypeSpec within build pipelines can be found here
| Name | Changelog | Latest | Next |
|---|---|---|---|
| @azure-tools/typespec-autorest | Changelog |  |
 |
| @azure-tools/typespec-azure-core | Changelog |  |
 |
| @azure-tools/typespec-resource-manager | Changelog |  |
 |
@next version of the package are the latest versions available on the main branch.
The main packages in this repository can be considered a series of layers which progressively add functionality for specific scenarios:
- @azure-tools/typespec-azure-core: Provides core models and interfaces for Azure service modelling
- @azure-tools/typespec-azure-resource-manager: Provides additional models and interfaces for modelling Azure Resource Manager services