HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
OpenAPITools
openapi-generator
Java2018–2025
OpenAPITools / openapi-generator

openapi-generator

OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)

43Distinct people
101Mentions
0Explicit recommenders
26.9KGitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)

GitHub

Where it is used

No documented product use was verified in the last source check.

What people are saying

No recommendation phrase was found in the indexed comments.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

Mentioned in the same Hacker News threads. That is not proof they are substitutes.

This week on Hacker News

Nov 7–Nov 14 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/14/2026, 6:01:08 PM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by year101 dated mentions

Observed mentions: 2018-06-02 02:49:00 UTC to 2025-11-24 00:55:21 UTC.

01020302018-01-01 00:00:00 UTC to 2019-01-01 00:00:00 UTC (exclusive): 10 mentions; 5 submissions, 5 comments20182019-01-01 00:00:00 UTC to 2020-01-01 00:00:00 UTC (exclusive): 35 mentions; 25 submissions, 10 comments2020-01-01 00:00:00 UTC to 2021-01-01 00:00:00 UTC (exclusive): 15 mentions; 6 submissions, 9 comments2021-01-01 00:00:00 UTC to 2022-01-01 00:00:00 UTC (exclusive): 10 mentions; 2 submissions, 8 comments20212022-01-01 00:00:00 UTC to 2023-01-01 00:00:00 UTC (exclusive): 12 mentions; 4 submissions, 8 comments2023-01-01 00:00:00 UTC to 2024-01-01 00:00:00 UTC (exclusive): 5 mentions; 1 submissions, 4 comments2024-01-01 00:00:00 UTC to 2025-01-01 00:00:00 UTC (exclusive): 10 mentions; 2 submissions, 8 comments2025-01-01 00:00:00 UTC to 2026-01-01 00:00:00 UTC (exclusive): 4 mentions; 0 submissions, 4 comments2025

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
20182018-01-01 00:00:00 UTC2019-01-01 00:00:00 UTC1055
20192019-01-01 00:00:00 UTC2020-01-01 00:00:00 UTC352510
20202020-01-01 00:00:00 UTC2021-01-01 00:00:00 UTC1569
20212021-01-01 00:00:00 UTC2022-01-01 00:00:00 UTC1028
20222022-01-01 00:00:00 UTC2023-01-01 00:00:00 UTC1248
20232023-01-01 00:00:00 UTC2024-01-01 00:00:00 UTC514
20242024-01-01 00:00:00 UTC2025-01-01 00:00:00 UTC1028
20252025-01-01 00:00:00 UTC2026-01-01 00:00:00 UTC404

From the project README

An excerpt from the repository, fetched Nov 13, 2026.

Read the project’s introduction
OpenAPI Generator Master (7.28.0): ⭐⭐⭐ If you would like to contribute, please refer to guidelines and a list of open tasks. ⭐⭐⭐ ‼️ To migrate from Swagger Codegen to OpenAPI Generator, please refer to the migration guide ‼️ 📔 For more information, please refer to the Wiki page and FAQ 📔 📔 The eBook A Beginner's Guide to Code Generation for REST APIs is a good starting point for beginners 📔 ⚠️ If the OpenAPI spec, templates or any input (e.g. options, environment variables) is obtained from an untrusted source or environment, please make sure you've reviewed these inputs before using OpenAPI Generator to generate the API client, server stub or documentation to avoid potential security issues (e.g. code injection). For security vulnerabilities, please contact team@openapitools.org. ⚠️ ‼️ Both "OpenAPI Tools" (https://OpenAPITools.org - the parent organization of OpenAPI Generator) and "OpenAPI Generator" are not affiliated with OpenAPI Initiative (OAI) ‼️ Sponsors If you find OpenAPI Generator useful for work, please consider asking your company to support this Open Source project by becoming a sponsor. You can also individually sponsor the project by becoming a backer. Thank you to our bronze sponsors! Thank you GoDaddy for sponsoring the domain names, Linode for sponsoring the VPS, Checkly for sponsoring the API monitoring and Gradle for sponsoring Develocity Overview OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (both 2.0 and 3.0 are supported). Currently, the following languages/frameworks are supported: Languages/Frameworks API clients ActionScript, Ada, Apex, Bash, C, C# (.net 2.0, 3.5 or later, .NET Standard 1.3 - 2.1, .NET Core 3.1, .NET 5.0. Libraries: RestSharp, GenericHost, HttpClient), C++ (Arduino, cpp-restsdk, Qt5, Tizen, Unreal Engine 4), Clojure, Crystal, Dart, Elixir, Elm, Eiffel, Erlang, Go, Groovy, Haskell (http-client, Servant), Java (Apache HttpClient 4.x, Apache HttpClient 5.x, Jersey2.x, OkHttp, Retrofit1.x, Retrofit2.x, Feign, RestTemplate, RESTEasy, Vertx, Google API Client Library for Java, Rest-assured, Spring 5 Web Client, Spring 6 RestClient, MicroProfile Rest Client, Helidon), Jetbrains HTTP Client, Julia, k6, Kotlin, Lua, N4JS, Nim, Node.js/JavaScript (ES5, ES6, AngularJS with Google Closure Compiler annotations, Flow types, Apollo GraphQL DataStore), Objective-C, OCaml, Perl, PHP, PowerShell, Python, R, Ruby, Rust (hyper, reqwest, rust-server), Scala (akka, http4s, scalaz, sttp, swagger-async-httpclient, pekko), Swift (2.x, 3.x, 4.x, 5.x, 6.x), Typescript (AngularJS, Angular (9.x - 19.x), Aurelia, Axios, Fetch, Inversify, jQuery, Nestjs, Node, redux-query, Rxjs), XoJo, Zapier Server stubs Ada, C# (ASP.NET Core, Azure Functions), C++ (Httplib, Oat++, Pistache, Restbed, Qt5 QHTTPEngine), Erlang, F# (Giraffe), Go (net/http, Gin, Echo), Haskell (Servant, Yesod), Java (MSF4J, Spring, Undertow, JAX-RS: CDI, CXF, Inflector, Jersey, RestEasy, Play Framework, PKMST, Vert.x, Apache Camel, Helidon), Julia, Kotlin (Spring Boot, Ktor, Vert.x), PHP (Flight, Laravel, Lumen, Mezzio (fka Zend Expressive), Slim, Silex, Symfony), Python (FastAPI, Flask), NodeJS, Ruby (Sinatra, Rails5), Rust (rust-server), Scala (Akka, Finch, Lagom, Play, Cask, Scalatra) API documentation generators HTML, Confluence Wiki, Asciidoc, Markdown, PlantUML Configuration files Apache2 Others GraphQL, JMeter, Ktorm, MySQL Schema, Postman Collection, Protocol Buffer, WSDL Table of contents Sponsors Thank you to our bronze sponsors! Thank you GoDaddy for sponsoring the domain names, Linode for sponsoring the VPS, Checkly for sponsoring the API monitoring and Gradle for sponsoring Develocity Overview Table of contents 1 - Installation 1.1 - Compatibility 1.2 - Artifacts on Maven Central 1.3 - Download JAR Launcher Script 1.4 - Build Projects Nix users 1.5 - Homebrew 1.6 - Docker Public Pre-built Docker images OpenAPI Generator CLI Docker Image OpenAPI Generator Online Docker Image Development in docker Troubleshooting Run Docker in Vagrant 1.7 - NPM 1.8 - pip 2 - Getting Started 3 - Usage To generate a sample client library 3.1 - Customization 3.2 - Workflow Integration (Maven, Gradle, Github, CI/CD) 3.3 - Online OpenAPI generator 3.4 - License information on Generated Code 3.5 - IDE Integration 4 - Companies/Projects using OpenAPI Generator 5 - Presentations/Videos/Tutorials/Books 6 - About Us 6.1 - OpenAPI Generator Core Team Core Team Members Template Creator How to join the core team 6.2 - OpenAPI Generator Technical Committee Members of Technical Committee 6.3 - History of OpenAPI Generator Founding Members (alphabetical order): 7 - License 1 - Installation 1.1 - Compatibility The OpenAPI Specification has undergone 3 revisions since initial creation in 2010. The openapi-generator project has the following compatibilities with the OpenAPI Specification: OpenAPI Generator Version Release Date Notes 7.28.0 (upcoming minor release) SNAPSHOT 20.11.2026 Minor release with breaking changes (with fallback) 7.27.0 (latest stable release) 02.11.2026 Minor release with breaking changes (with fallback) 6.6.0 11.05.2023 Minor release with breaking changes (with fallback) 5.4.0 31.01.2022 Minor release with breaking changes (with fallback) 4.3.1 06.05.2020 Patch release (enhancements, bug fixes, etc) OpenAPI Spec compatibility: 1.0, 1.1, 1.2, 2.0, 3.0, 3.1 (beta support) (We do not publish daily/nightly build. Please use SNAPSHOT instead) For old releases, please refer to the Release page. For decommissioned generators/libraries/frameworks, please refer to the "Decommission" label in the pull request page. 1.2 - Artifacts on Maven Central You can find our released artifacts on maven central: Core: <dependency> <groupId>org.openapitools</groupId> <artifactId>o
Read the full README on GitHub

What Hacker News says

10 sources
Does apimatic use the following open-source code generators or it builds a proprietary code generator from scratch? Swagger Codegen: https://github.com/swagger-api/swagger-codegen OpenAPI Generator: https://github.com/OpenAPITools/openapi-generator AutoRest: https://github.com/Azure/AutoRest NSwag: https://github.com/RicoSuter/NSwag oapi-codegen: https://github.com/deepmap/oapi-codegen go-swagger: https://github.com/go-swagger/go-swagger
In Adopting the OpenAPI schema to generate Plaid’s SDKs
I think the core goal is to have one machine-readable source of truth for your API. You can write docs, the API interface, API input validation, API correctness tests, performance tests, and 10 per-language SDKs & clients all by hand, but then they very quickly get out of sync, and nobody knows which is 'right'. If you write docs as prose, good luck keeping it updated when management wants it translated into 10 languages and the API changes every week. Meanwhile, at least in theory, with a good central spec you can generate at least the docs & much of this code, or alternatively automatically validate custom implementations & real traffic to get immediate warnings if there are discrepancies. There's a lot of power in formal specifications. That is all dependent on tooling though. OpenAPI is far ahead in that respect, and can achieve this
Read the rest
goal for most HTTP APIs & a huge list of languages (see https://github.com/OpenAPITools/openapi-generator) pretty effectively. AsyncAPI is much newer though, and I think the ecosystem is still quite small, but hopefully they'll get there too eventually.
In AsyncAPI vs. OpenAPI: Answers to Your Burning Questions
This is the approach I use, but I've always found some sort of issue in every generator I use. A valid openapi spec does not imply a generator will be able to handle it. You'd think have a specification would mean the generators are "bug free" but it's not the case, and bug reports are lost in a sea of issues: https://github.com/OpenAPITools/openapi-generator/issues so i don't see things improving anytime soon. I've also wondered if the "logic-less" template approach is the right approach for these generators. You can't fix bugs or add workarounds just by providing a custom template, you need to change the underlying Java code to provide the correct data models to the logic-less templates.
In Laravel Transporter
wing328hk·Apr 21, 2021Submission

Show HN: Go Echo Server Generator

Hi all, We've just added a Go Echo server generator [1] to the openapi-generator project [2]. Please give it a try by following 3 simple steps below: 1. Download the Java JAR: https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-g… 2. Rename the JAR as "openapi-generator-cli.jar" 3. Execute the following command to run the generator for the Petstore API: https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/op… Mac/Linux: $ java -jar openapi-generator-cli.jar generate -g go-echo-server -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/op… -o /var/tmp/go-echo-server/ Windows: $
Read the rest
java -jar openapi-generator-cli.jar generate -g go-echo-server -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/op… -o C:\tmp\go-echo-server If you've any feedback or question, please let us know via https://github.com/OpenAPITools/openapi-generator/issues/new. Thank you Farshad Nematdoust [3] for contributing the Go Echo server generator [4]. [1] https://github.com/labstack/echo [2] https://github.com/openapitools/openapi-generator/ [3] https://github.com/ph4r5h4d [4] https://github.com/OpenAPITools/openapi-generator/pull/9224
1 points · Open discussion
I've built a tiny pet project [0] that uses JSON Schemas [1] extensively. Data is defined by the schema and it's used to build a static JSON API on GitHub Pages. OpenAPI [2] definition for API reuses data schema and you can use OpenAPI Generator [3] to generate clients. The site uses docsify [4] to display repo's README nicely. [0] https://beatcracker.github.io/toptout/ [1] https://json-schema.org/ [2] https://swagger.io/specification/ [3] https://github.com/OpenAPITools/openapi-generator [4] https://docsify.js.org/
In Ask HN: What novel tools are you using to write web sites/apps?
I agree with you that some generators are less mature. For example, we just added a Crystal client generator several weeks ago and we only have tests for posting a JSON body and getting it back to verify the result. Features like oneOf, anyOf are not yet supported (of course we welcome contributions to improve the Crystal client generator). You can use customized templates (e.g. via -t option in the CLI) to meet your unique requirements. Another tips is to use code formatter such as https://prettier.io/, eslint etc to format the auto-generated code based on the style you want. Please open an issue via http://github.com/OpenAPITools/openapi-generator/issues/new if you need help with OpenAPI Generator. Disclosure: I'm the top contributor to OpenAPI Generator
In Ask HN: Should we waste hours writing REST API clients?

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.