---
id: halo
version: "0.0.31"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# halo — Beautiful terminal spinners in Python

License: permissive · Maintenance: dormant · Downloads: 1.2M/mo

## What it is and what it does

Halo is a Python library that renders animated spinners in the terminal to provide visual feedback during long-running operations. It wraps text with a rotating animation frame, letting you indicate that work is in progress without blocking output. The package supports multiple spinner styles, custom colors for both text and spinner, and terminal placement options (left or right of text). It integrates with IPython and Jupyter notebooks as well as standard terminal environments.

You can use halo as a context manager (with statement), a decorator, or by calling start/stop methods directly. It provides terminal-friendly completion symbols—checkmark for success, X for failure, warning triangle, or info icon—and lets you update the spinner text dynamically. The library depends on log-symbols, spinners, termcolor, colorama, six, and backports.shutil-get-terminal-size to handle cross-platform terminal rendering and color output.

Use it for:

- Show a spinner while downloading files or making network requests to indicate the operation is ongoing
- Display progress feedback during long-running data processing or database queries in CLI tools
- Provide visual status during build or deployment scripts, ending with success or failure symbols
- Add loading indicators to interactive CLI applications that perform background tasks
- Decorate long-running functions to automatically show a spinner without manual start/stop calls

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Halo displays animated spinners in the terminal to indicate progress or loading state during long-running operations, with support for custom text, colors, and completion symbols.

Yes, if you need terminal spinners in a CLI tool or script. The package is stable, has low install friction, carries no known vulnerabilities, and is permissively licensed. The dormant maintenance status is not a blocker for a mature, single-purpose library—but verify compatibility with your target Python versions and terminal environment before relying on it for new projects.

## Install

pip install halo
uv add halo
poetry add halo

## Installing halo

Before you install: Low install friction with six runtime dependencies. Maintenance is dormant—last release was 2020-11-10 and no commits since 2024-06-16—but the package is stable and widely used (monthly downloads in the millions, top 5000 on PyPI).

License in practice: MIT license is permissive; you can use, modify, and distribute halo freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install halo

from halo import Halo

spinner = Halo(text='Loading', spinner='dots')
spinner.start()
# Run time consuming work here
spinner.stop()

Verify before relying:

- Whether the package works reliably with Python versions beyond 3.8 (classifiers list only up to 3.8, but requires_python is >=3.4)
- Current compatibility with modern terminal emulators and Windows console changes since 2020

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 1.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

terminal spinner animation, loading indicator cli, progress spinner python, terminal busy indicator, cli loading animation, python terminal spinner, async task indicator, cli-ui, terminal-output

[View on SkillFed](https://skillfed.io/packages/halo) · [View on PyPI](https://pypi.org/project/halo/)