# danijar/handout

Turn Python scripts into handouts with Markdown and figures

Repository: https://github.com/danijar/handout
Canonical: https://ross.abutalabs.com/products/handout
Language: Python
License: Apache-2.0
License Family: permissive
Topics: python, data-science, notebook, prototyping, research, productivity
Last push: 2021-08-28T07:48:24+00:00

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

## Adoption (not part of the score)
Stars 2030, forks 105 (observed 2026-08-28T04:06:07.237069+00:00)

## What it is
A Python library that turns ordinary Python scripts into browsable handouts with Markdown comments and inline figures, as an alternative to Jupyter notebooks without hidden state. Users add text, images, videos, and matplotlib figures via a simple API and view the result as generated HTML.

## Use cases
- turn python scripts into readable documents with figures
- jupyter notebook alternative without hidden state
- document research experiments with inline plots
- share data science results as html handouts
- prototype and visualize results from any text editor
- add markdown comments and matplotlib figures to scripts

## When to avoid
- you need interactive cell-by-cell execution like Jupyter
- you need rich notebook features like widgets or live code
- you need actively developed tooling with frequent updates

## Facets
- artifact type: library
- maturity: maintenance
- function: data-visualization, documentation, developer-tools
- domain: data-science, developer-tools, documentation
- platform: python, cli, cross-platform
- tags: notebook-alternative, prototyping, research, matplotlib, markdown

## Member repositories
- danijar/handout (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:07.237069+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-30T02:59:35.167225+00:00, confidence not recorded.
  - readme: https://github.com/danijar/handout (fetched 2026-08-28T04:06:07.237069+00:00, sha da27d0aa6512)
  - registry_pypi: https://pypi.org/pypi/handout/json (fetched 2026-08-29T10:39:33.245404+00:00, sha 548569e8a118)
- Data as of 2026-08-30T08:39:29.467469+00:00.