Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Smithy

smithy.io

  • Free plan
  • Windows
  • macOS
  • Linux
7.6 Club score Visit smithy.io

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.