hey-api/hey-api
👨🚀 Turn API specifications into production-ready SDKs, validators, mocks, and more. 20+ plugins. Millions of weekly npm downloads. Used by Vercel, OpenCode, PayPal, AWS, Autodesk, and many more. observed · 2026-08-28
Health v2 · maintenance only
85/100
- Activity 99
- Release rhythm 77
- Longevity 69
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.
- gap_med: 0
- age_days: 966
- days_rel: 72
- days_push: 9
- n_releases_24m: 326
Adoption not part of the score
5316 stars · 426 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded
Hey API is an ecosystem of code generators that turn OpenAPI specifications into production-ready SDKs, types, validators, and mocks. Its flagship @hey-api/openapi-ts generates TypeScript clients with 20+ plugins (Zod schemas, TanStack Query hooks, multiple HTTP clients), with a Python generator also available.
Use cases
- generate a typescript sdk from an openapi spec
- generate zod schemas from swagger json
- create typed api client for axios or fetch
- generate tanstack query hooks from openapi
- generate python sdk with pydantic models from openapi
- mock api responses from an openapi specification
- keep frontend api client in sync with backend spec
When to choose
- you have an OpenAPI/Swagger spec and want typed, production-ready client code without hand-writing it
- you want generated validators (Zod, Valibot) and state-management hooks alongside your SDK
- you need multiple HTTP client targets (Axios, Fetch, Ky, Next.js, Nuxt, Angular) from one spec
When to avoid
- your API has no OpenAPI specification to generate from
- you need a stable custom plugin API - the plugin interface is still in development
- you want a runtime API gateway or proxy rather than generated client code
Facets
cli-tool · maturity active
sdk parser http-client mock-api plugin-system developer-tools apis web-development developer-tools frontend backend cli cross-platform openapi swagger typescript zod tanstack-query sdk-generation codegen pydantic python code-generation nodejs
7 sources
- readme: https://github.com/hey-api/hey-api · fetched 2026-08-28 · 763e602ee850
- homepage: https://heyapi.dev · fetched 2026-08-29 · 654e62be1fed
- site_page: https://heyapi.dev/docs/openapi/typescript/get-started · fetched 2026-08-29 · f6f1ad8867e6
- site_page: https://heyapi.dev/docs/openapi/typescript/core · fetched 2026-08-29 · 227b86de690d
- site_page: https://heyapi.dev/docs/openapi/typescript/clients · fetched 2026-08-29 · dfa44b9d85a1
- site_page: https://heyapi.dev/docs/openapi/typescript/plugins/custom · fetched 2026-08-29 · bbfd69adec77
- site_page: https://heyapi.dev/docs · fetched 2026-08-29 · 9280f91d6e7c
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| hey-api/hey-api | main | 85 |
For agents
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem