Smithy
smithy.io
- Free plan
- Windows
- macOS
- Linux
What Smithy is
Smithy is an open-source, protocol-agnostic interface definition language and toolset for modeling services and generating API artifacts. A single model can produce type-safe client SDKs for TypeScript, Python, Go, Rust, Kotlin, Swift, Java, Scala, Ruby, and Dafny, plus server code for TypeScript, Java, Python, Go, and Rust. It also generates API reference documentation, OpenAPI, and JSON Schema. The same service model can describe REST JSON, RPC v2 CBOR, AWS JSON, and AWS Query or XML protocols. Resource-based modeling can produce artifacts such as CloudFormation schemas. During a Smithy build, the tooling validates model standards and checks revisions for backward compatibility. The CLI builds, validates, compares, and queries models without requiring Java or Smithy Gradle Plugins. It runs on macOS x86 and ARM, Linux x86 and ARM, and Windows x64. Release archives are PGP-signed and hashed, with documented signature and checksum checks. Maven dependencies and plugins can add extensions and code generators, including AWS-specific dependencies and an OpenAPI generator. Smithy is maintained by AWS and the open-source community.
Who it suits
Smithy suits teams defining service APIs that need SDKs, server implementations, documentation, and multiple protocol targets from shared models. It is also relevant to developers working with AWS integrations or open-source tooling.
Good to know, and what to watch
- Generates SDKs in ten client languages
- Supports multiple API protocols
- Produces OpenAPI and JSON Schema
- Checks revisions for backward compatibility
- Cross-platform CLI with signed releases
- Requires modeling and build-tool expertise
- Server support covers five listed languages
- Open-source project support uses GitHub issues
The verdict
Smithy gives API teams a shared model for generating clients, servers, and documentation across languages and protocols. Its validation, compatibility checks, and AWS connections make the model-driven workflow broad, while adoption requires familiarity with interface modeling.
What the maker publishes
- API protocols
- The same service model can support REST JSON, RPC v2 CBOR, AWS JSON, and AWS Query/XML protocols. source
- AWS integrations
- Smithy documents integrations with AWS services and tools including API Gateway, CloudFormation, and AWS SDKs. source
- AWS use
- Smithy says it was created and is used at AWS, and that it powers AWS APIs and SDKs. source
- CLI
- The Smithy CLI can build models, run ad hoc validation, compare models, and query models without requiring users to set up Java or Smithy Gradle Plugins. source
- Client languages
- The site lists client SDKs for TypeScript, Python, Go, Rust, Kotlin, Swift, Java, Scala, Ruby, and Dafny. source
- CLI platforms
- The Smithy CLI is supported on macOS for x86 and ARM, Linux for x86 and ARM, and Windows x64. source
- Code generation
- A single model can generate type-safe client SDKs in ten languages, server code, API reference documentation, OpenAPI, and JSON Schema. source
- Code generation
- A single Smithy model can generate type-safe clients, servers, documentation, OpenAPI, and JSON Schema. source
- Community and maintenance
- The site says Smithy is maintained by AWS and the open-source community and links to community resources and GitHub issues. source
- Download verification
- Smithy CLI release archives are PGP-signed and hashed, and the installation guide describes verifying their signatures and checksums. source
- Governance
- Smithy validates model standards during smithy build and checks model revisions for backward compatibility. source
- Governance
- Smithy validates model standards during smithy build and checks revisions for backward compatibility. source
- Integrations
- Smithy build configurations can load extensions and code generators through Maven dependencies and plugins, including AWS-specific dependencies and an OpenAPI generator. source
- Intended users
- Smithy is presented for teams defining service APIs and generating SDKs, server code, and documentation across programming languages. source
- License
- The project is open source under the Apache 2.0 license. source
- License
- The site identifies Smithy as open source under the Apache 2.0 license. source
- Modeling
- Smithy supports resource-based API modeling, which can be used to generate artifacts including CloudFormation schemas, SDKs, and documentation. source
- Product
- Smithy is an open-source, protocol-agnostic interface definition language and toolset for defining APIs and generating clients, servers, and documentation. source
- Protocols
- Smithy describes support for REST JSON, RPC v2 CBOR, AWS JSON, and AWS Query protocols. source
- Purpose
- Smithy is an open-source interface definition language for modeling services and SDKs. source
- Security
- The Smithy CLI installation guide says release archives are PGP-signed and hashed, and describes verifying signatures and checksums. source
- Server languages
- The site lists server support for TypeScript, Java, Python, Go, and Rust. source
- Support
- The CLI guide directs users with suggestions or issues to create an issue in the Smithy GitHub repository. source
- Supported CLI platforms
- The Smithy CLI is supported on macOS x86 and ARM, Linux x86 and ARM, and Windows x64. source
Checked against the maker's pages on 9 Oct 2026.