# daveshanley/vacuum

vacuum is the worlds fastest and most versatile OpenAPI, AsyncAPI & JSON Schema linter, docs generator and toolkit. It tears through API specs at light speed. 100% compatible with Spectral rulesets, and OpenAPI 3.0, 3.1 and 3.2

Repository: https://github.com/daveshanley/vacuum
Canonical: https://ross.abutalabs.com/products/vacuum
Homepage: https://quobix.com/vacuum
Language: Go
License: MIT
License Family: permissive
Topics: golang, lint, linters, linting, openapi, openapi-spec, openapi-specification, swagger-spec, go, oas, spectral, linter, openapi3, stoplight, openapi31, openapi3-1, openapi3-validation, owasp, json-schema, json-schema-validator
Last push: 2026-09-02T18:17:50+00:00

## Health v2 (maintenance only)
Score: 96/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 100, release rhythm 88, longevity 100
- inputs: {"age_days": 1788, "days_push": 0, "days_rel": 0, "gap_med": 2.0, "n_releases_24m": 123}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1123, forks 87 (observed 2026-09-03T02:15:11.187666+00:00)

## What it is
vacuum is an ultra-fast OpenAPI, AsyncAPI, and JSON Schema linter and quality-checking tool written in Go, fully compatible with Spectral rulesets. It ships as a CLI with a dashboard UI, a Go library/SDK, a VSCode plugin, a GitHub Action, and can generate static API documentation from specs.

## Use cases
- lint openapi specs in ci
- validate asyncapi contracts
- check json schema quality
- migrate from spectral to a faster linter
- enforce owasp api security rules on openapi files
- generate static api documentation from openapi
- lint large openapi specs quickly
- run api spec quality checks in github actions

## When to choose
- you need Spectral-compatible linting with much better performance
- you lint thousands of OpenAPI specs at scale or in CI pipelines
- you want linting plus docs generation and editor diagnostics in one tool
- you need OWASP, OpenAPI 3.0/3.1/3.2, AsyncAPI, and JSON Schema rule coverage

## When to avoid
- you depend on Spectral-specific behavior or plugins, since vacuum is not Spectral
- you need a JavaScript/TypeScript-extensible linter with custom JS rules beyond vacuum's model
- you only need simple YAML/JSON linting unrelated to API specifications

## Facets
- artifact type: cli-tool
- maturity: active
- function: linter, cli, documentation, sdk, security, api-documentation
- domain: apis, developer-tools, documentation, security, parsers
- platform: go, cli, windows, editor-plugin
- tags: openapi, asyncapi, json-schema, spectral-compatible, swagger, api-quality, owasp, ci-cd, api-docs-generation, rulesets, docker, macos, linux, nodejs

## Member repositories
- daveshanley/vacuum (main) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:11.187666+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:41:05.404277+00:00, confidence not recorded.
  - readme: https://github.com/daveshanley/vacuum (fetched 2026-09-03T02:15:11.187666+00:00, sha 2fa0abd1d902)
  - homepage: https://quobix.com/vacuum (fetched 2026-08-29T12:44:57.102087+00:00, sha 8bddd0bf5b2f)
  - site_page: https://quobix.com/vacuum/commands/docs (fetched 2026-08-29T12:44:57.104781+00:00, sha 67a0b04e58b1)
  - site_page: https://quobix.com/vacuum/api/getting-started (fetched 2026-08-29T12:44:57.107083+00:00, sha daa377ab9dff)
  - site_page: https://quobix.com/vacuum/about (fetched 2026-08-29T12:44:57.109022+00:00, sha 575509edadbc)
  - site_page: https://quobix.com/vacuum/installing (fetched 2026-08-29T12:44:57.110818+00:00, sha fb43dc162e03)
  - site_page: https://quobix.com/vacuum/api-docs (fetched 2026-08-29T12:44:57.115647+00:00, sha c3fcd57b3592)
  - site_page: https://quobix.com/vacuum/faq (fetched 2026-08-29T12:44:57.112344+00:00, sha 7bcf5b6e462e)
  - site_page: https://quobix.com/vacuum/changelog (fetched 2026-08-29T12:44:57.114130+00:00, sha ed25d42de02c)
- Data as of 2026-08-30T08:39:29.467469+00:00.