# pallets/click

Python composable command line interface toolkit

Repository: https://github.com/pallets/click
Canonical: https://ross.abutalabs.com/products/click
Homepage: https://click.palletsprojects.com
Language: Python
License: BSD-3-Clause
License Family: permissive
Topics: python, cli, click, pallets
Last push: 2026-08-25T01:48:48+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 87, longevity 100
- inputs: {"age_days": 4514, "days_push": 9, "days_rel": 6, "gap_med": 47, "n_releases_24m": 12}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 17635, forks 1953 (observed 2026-08-28T04:11:20.109633+00:00)

## What it is
Click is a Python package for creating composable command line interfaces with minimal code, using decorators to turn functions into CLI commands. It provides arbitrary command nesting, automatic help page generation, and lazy loading of subcommands.

## Use cases
- build a python cli tool
- parse command line arguments in python
- create nested subcommands like git
- auto-generate help pages for a cli
- prompt users for input in a terminal app
- build a plugin-based cli with lazy-loaded commands

## When to choose
- writing a Python command line tool with options, arguments, and subcommands
- you want automatic, well-formatted help pages
- you need composable, nestable command groups
- you want sensible defaults with room for deep configuration

## When to avoid
- building CLIs in languages other than Python
- you need a full TUI (terminal user interface) with panels and widgets
- a tiny script where argparse from the stdlib suffices and you want zero dependencies

## Facets
- artifact type: library
- maturity: stable
- function: cli, developer-tools
- domain: developer-tools
- platform: python, cross-platform, cli
- tags: cli-framework, decorators, argument-parsing, pallets, subcommands, help-generation, command-line, automation

## Member repositories
- pallets/click (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:20.109633+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:02:33.512199+00:00, confidence not recorded.
  - readme: https://github.com/pallets/click (fetched 2026-08-28T04:11:20.109633+00:00, sha 4c3de4aa0918)
  - homepage: https://click.palletsprojects.com (fetched 2026-08-29T08:00:51.730408+00:00, sha 3965ee2417e2)
  - site_page: https://click.palletsprojects.com/en/stable/quickstart (fetched 2026-08-29T08:00:51.735897+00:00, sha 18f14370f549)
  - site_page: https://click.palletsprojects.com/en/stable/documentation (fetched 2026-08-29T08:00:51.738591+00:00, sha 27fd829f6426)
  - registry_pypi: https://pypi.org/pypi/click/json (fetched 2026-08-29T08:00:51.740850+00:00, sha 4d3ac777e54c)
  - site_page: https://click.palletsprojects.com/en/stable/faqs (fetched 2026-08-29T08:00:51.733530+00:00, sha 695e59ce013a)
- Data as of 2026-08-30T08:39:29.467469+00:00.