Skip to content
SPECIFICTION
Get listed

OpenAPI 3 Generator

github.com

LinuxSelf-hosted
Visit github.com
Spec score 7.0 #26 of 27 in API Documentation Tools

Spec sheet

Purpose
OpenAPI 3 Generator uses an OpenAPI 3 definition to generate code, documentation, and other outputs.Read 10 Oct 2026 · github.com
License
The repository includes an Apache License, Version 2.0.Read 10 Oct 2026 · github.com
CLI
The tool can be installed globally with npm and run from the command line as `og`.Read 4 Oct 2026 · github.com
CLI input
The CLI accepts an OpenAPI file or URL and a template as inputs.Read 10 Oct 2026 · github.com
Customization
A template can define Handlebars helpers in a `.helpers` directory and partials in a `.partials` directory.Read 10 Oct 2026 · github.com
Data available
The generator passes the OpenAPI specification to templates and provides `openapi.endpoints` for first-level endpoints.Read 10 Oct 2026 · github.com
Dependencies
The package lists Handlebars, YAML parsing, OpenAPI validation, and Markdown generation dependencies.Read 4 Oct 2026 · github.com
Dependency
The package lists Handlebars as a dependency.Read 10 Oct 2026 · github.com
Distribution
The README documents global npm installation and command-line use.Read 10 Oct 2026 · github.com
Input
The CLI accepts an OpenAPI file or URL and a template as arguments.Read 4 Oct 2026 · github.com
Input formats
The README shows an OpenAPI definition in YAML format as an example input.Read 4 Oct 2026 · github.com
Installation
The README gives `npm install -g openapi3-generator` as the CLI installation command.Read 10 Oct 2026 · github.com
Maintainers
The README lists Fran Méndez and Richard Klose as authors.Read 10 Oct 2026 · github.com
Requirements
The project lists Node.js v7.6 or later as a requirement.Read 4 Oct 2026 · github.com
Runtime requirement
The README lists Node.js v7.6+ as a requirement.Read 10 Oct 2026 · github.com
Support channel
The repository page provides an Issues section for the project.Read 10 Oct 2026 · github.com
Template data
Templates receive the OpenAPI specification and an `openapi.endpoints` value containing first-level endpoints.Read 4 Oct 2026 · github.com
Templates
Templates can contain static files, Handlebars templates, and path templates that generate a file for each OpenAPI path.Read 10 Oct 2026 · github.com

Where Specifiction places it

Alternatives to OpenAPI 3 GeneratorAll alternatives →