# hugapi/hug

Embrace the APIs of the future. Hug aims to make developing APIs as simple as possible, but no simpler.

Repository: https://github.com/hugapi/hug
Canonical: https://ross.abutalabs.com/products/hug
Language: Python
License: MIT
License Family: permissive
Topics: hug-api, python-api, falcon, python, python3, http, http-server, command-line
Last push: 2024-07-04T14:37:30+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4065, "days_push": 790, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6883, forks 391 (observed 2026-08-28T04:09:51.105535+00:00)

## What it is
Hug is a Python 3+ API framework built on Falcon's high-performance HTTP library, designed to make developing REST APIs as simple as writing a function definition. It encourages self-documenting code, easy testing, and also supports exposing functions via a command-line interface.

## Use cases
- build a REST API in Python with minimal boilerplate
- expose Python functions as HTTP endpoints automatically
- generate self-documenting APIs with built-in documentation
- create CLI tools from the same functions used for APIs
- quickly prototype Python microservices
- write easily testable HTTP APIs

## When to choose
- you want the fastest path from a Python function to a working HTTP API
- you value self-documenting endpoints and built-in API docs
- you need both HTTP API and CLI access to the same logic
- you want a lightweight framework on top of Falcon's performance

## When to avoid
- you need a framework with a large active ecosystem and frequent updates
- you require async-first architecture or modern ASGI integration
- you need extensive middleware, auth, or ORM integrations out of the box
- you're starting a new long-term project and want actively developed alternatives like FastAPI

## Facets
- artifact type: framework
- maturity: maintenance
- function: api-framework, http-server, routing, cli
- domain: web-development, backend, apis, developer-tools
- platform: python, cross-platform
- tags: rest, falcon, python3-only, rpc, self-documenting-apis

## Member repositories
- hugapi/hug (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:51.105535+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-29T17:41:40.047003+00:00, confidence not recorded.
  - readme: https://github.com/hugapi/hug (fetched 2026-08-28T04:09:51.105535+00:00, sha bf0529c861ff)
  - registry_pypi: https://pypi.org/pypi/hug/json (fetched 2026-08-29T08:37:29.551569+00:00, sha a493225fb4fe)
- Data as of 2026-08-30T08:39:29.467469+00:00.