# Qix-/better-exceptions

Pretty and useful exceptions in Python, automatically.

Repository: https://github.com/Qix-/better-exceptions
Canonical: https://ross.abutalabs.com/products/better-exceptions
Language: Python
License: MIT
License Family: permissive
Last push: 2026-07-10T10:48:18+00:00

## Health v2 (maintenance only)
Score: 64/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 91, release rhythm 8, longevity 100
- inputs: {"age_days": 3461, "days_push": 54, "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 4720, forks 226 (observed 2026-08-28T04:08:57.510099+00:00)

## What it is
A Python library that automatically replaces the default exception output with pretty, colorized, and more informative tracebacks that include local variable values. It works out of the box via an environment variable and integrates with the REPL, unittest, and Django.

## Use cases
- make Python tracebacks easier to read
- show local variables in exception output
- debug failing Python scripts faster
- format unittest exception output nicely
- get better error pages in Django development

## When to choose
- you spend time squinting at default Python tracebacks
- you want zero-effort improved debugging output during development
- you want to see variable values at each frame of a traceback

## When to avoid
- in production, where verbose locals can leak sensitive data into logs
- you need a full interactive debugger like pdb rather than prettier output

## Facets
- artifact type: library
- maturity: active
- function: developer-tools, error-handling, logging, testing
- domain: developer-tools
- platform: python, cross-platform, cli
- tags: exceptions, debugging, traceback, pretty-printing, developer-experience, python

## Member repositories
- Qix-/better-exceptions (main) score 64

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:57.510099+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-29T18:19:05.867509+00:00, confidence not recorded.
  - readme: https://github.com/Qix-/better-exceptions (fetched 2026-08-28T04:08:57.510099+00:00, sha 021715a6c2b4)
  - registry_pypi: https://pypi.org/pypi/better-exceptions/json (fetched 2026-08-29T09:02:50.896523+00:00, sha e3aed639bb7d)
- Data as of 2026-08-30T08:39:29.467469+00:00.