# manrajgrover/halo

💫 Beautiful spinners for terminal, IPython and Jupyter

Repository: https://github.com/manrajgrover/halo
Canonical: https://ross.abutalabs.com/products/manrajgrover-halo
Language: Python
License: MIT
License Family: permissive
Topics: halo, spinner, python, jupyter, ora, ipython, async
Last push: 2024-06-16T08:11:53+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": 3286, "days_push": 808, "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 3021, forks 148 (observed 2026-08-28T04:07:38.467738+00:00)

## What it is
Halo is a Python library that renders beautiful animated spinners in the terminal, IPython, and Jupyter notebooks to indicate ongoing work. It supports context managers, decorators, customizable spinner frames, colors, text animations, and async support.

## Use cases
- show a loading spinner while a long-running task executes in a CLI
- add a busy indicator to a Jupyter notebook cell
- wrap a slow function with a spinner using a decorator
- display progress feedback during API calls or downloads in Python scripts
- customize spinner frames, colors, and text animation in terminal apps

## When to choose
- you need a polished terminal spinner in Python with minimal setup
- you want spinner support in IPython or Jupyter environments
- you prefer decorator or context-manager usage for long-running functions

## When to avoid
- you need full progress bars rather than spinners (use tqdm or rich)
- you are building non-Python CLI tools
- you need a library under very active development

## Facets
- artifact type: library
- maturity: maintenance
- function: cli, developer-tools
- domain: developer-tools
- platform: python, cli, cross-platform
- tags: spinner, terminal-ui, ipython, jupyter, progress-indicator, async, command-line

## Member repositories
- manrajgrover/halo (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:38.467738+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-30T07:29:55.916891+00:00, confidence not recorded.
  - readme: https://github.com/manrajgrover/halo (fetched 2026-08-28T04:07:38.467738+00:00, sha 0225781c9a58)
  - registry_pypi: https://pypi.org/pypi/halo/json (fetched 2026-08-29T09:45:01.823223+00:00, sha cd399cc65156)
- Data as of 2026-08-30T08:39:29.467469+00:00.