click-spinner
Spinner for Click
Decision gist · record as of 2026-08-14
Yes. The package is actively maintained, has no dependencies, installs cleanly, carries a permissive license, and solves a specific, common problem in CLI development. Install it when you need terminal spinner functionality in a Python 3.8+ project.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.8 or later; for Python <3.8, use v0.1.11.
- Installs with no runtime dependencies and maintains active status with recent releases, making it straightforward to add to any project.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects.
last release 2026-06-23 (52 days) · last repo commit 2026-07-30 · 296 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 3,864,914 downloads/mo, #2,474 on PyPI
Alternatives
Verify before relying
pip install click-spinner
import click_spinner
with click_spinner.spinner():
# long-running operation here
pass- Whether the spinner output is compatible with all terminal types and environments (Windows, macOS, Linux).
- Performance characteristics when used in high-frequency or long-running operations.
What it is and what it does
Click Spinner is a lightweight terminal utility that displays an animated spinner to indicate ongoing work when you cannot predict how long an operation will take. It wraps your code in a context manager, showing a simple animated character sequence while the block executes, then clearing it when done.
The package has no runtime dependencies and integrates directly into CLI applications built with Click or any other framework. It's designed for cases where a progress bar is inappropriate—when you genuinely don't know the duration—and you just need to signal to the user that something is happening.
Use it for
- Show progress during long-running API calls or network requests where duration is unpredictable.
- Indicate activity during database queries or file I/O operations in CLI tools.
- Provide visual feedback during background tasks in scripts or automation workflows.
- Enhance user experience in command-line tools by replacing silent waits with animated feedback.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is actively maintained, has no dependencies, installs cleanly, carries a permissive license, and solves a specific, common problem in CLI development. Install it when you need terminal spinner functionality in a Python 3.8+ project.
Install
click-spinner on PyPI
Before you install
Installs with no runtime dependencies and maintains active status with recent releases, making it straightforward to add to any project.
Requires Python 3.8 or later; for Python <3.8, use v0.1.11.
License in practice
MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects.
Quickstart
pip install click-spinner
import click_spinner
with click_spinner.spinner():
# long-running operation here
passVerify before relying
- Whether the spinner output is compatible with all terminal types and environments (Windows, macOS, Linux).
- Performance characteristics when used in high-frequency or long-running operations.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <4,>=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 52 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 3,864,914 / month, #2,474 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: click_spinner-0.2.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “progress indicator cli”
- click-spinnerDisplays a simple animated spinner in the terminal to show progress…
- haloHalo displays animated spinners in the terminal to indicate progress…
- yaspinYaspin displays an animated terminal spinner to indicate progress…
Give your agent the search over MCP, or paste the wish link into any chat.
More Terminals packages
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
Rich renders styled text, tables, progress bars, syntax highlighting, markdown, and tracebacks to the terminal with minimal code.
Colorama makes ANSI escape sequences for colored terminal text work on Windows by intercepting and converting them to win32 API calls, while passing through unchanged on other platforms.
Install it if you need colored terminal output to work on Windows or want to use ANSI-based libraries portably; skip it only if you target non-Windows platforms…
Measures the displayed width of Unicode strings in terminals, accounting for wide characters, combining marks, and terminal escape sequences that standard Python string functions mishandle.
Install it if your application formats text for terminals and handles non-ASCII characters.
Run a subprocess in a pseudo terminal (pty) and interact with its input and output, enabling automation of interactive programs that require terminal features like password prompts or curses-style interfaces.
However, note that it is aging (last release 2020-12-28) and not actively maintained; it works well for its narrow, well-defined purpose but won't receive updates for…
Pexpect spawns and controls interactive console applications by sending input and matching output patterns, automating tasks that would otherwise require manual interaction.
See also clickclick · halo · spinners · progress · yaspin · alive-progress · progressbar2 · types-click-spinner · progressbar33 · enlighten