yaspin
Yet Another Terminal Spinner
Decision gist · record as of 2026-08-14
Yes, if you need a lightweight, low-friction terminal spinner for CLI tools or scripts. The library is mature (Production/Stable), has no security vulnerabilities, and integrates easily via context manager or decorator. However, maintenance is aging (251 days since last release), so consider this if you need active bug fixes or Python version support updates; for stable, fire-and-forget use cases it is reliable.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later (supports 3.10, 3.11, 3.12, 3.13, 3.14).
- Terminal must support ANSI escape sequences for spinner animation.
- Low friction: pure Python wheel with a single runtime dependency (termcolor).
License · maintenance · safety
MIT (permissive) — MIT license (permissive) imposes no restrictions on use, modification, or distribution in proprietary or open-source projects.
last release 2025-12-06 (251 days) · last repo commit 2026-02-12 · 915 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 6,249,241 downloads/mo, #1,947 on PyPI
Alternatives
Verify before relying
pip install yaspin
import time
from yaspin import yaspin
with yaspin(text="Loading") as spinner:
time.sleep(2)
spinner.ok("✅")- Whether aging maintenance status (251 days since last release) affects compatibility with newer Python patch versions or terminal emulators.
- Performance characteristics when used with very high-frequency spinner updates or in resource-constrained environments.
What it is and what it does
Yaspin is a terminal spinner library that animates a loading indicator while code executes, helping users understand that a long-running operation is still in progress. It wraps operations via context manager or function decorator, requiring minimal code changes to integrate into existing projects. The library supports 70+ spinner animations from cli-spinners, all termcolor colors and text attributes (bold, blink, etc.), and allows dynamic updates to spinner style, text, and color mid-operation. Output goes to stdout by default but can be redirected to any stream, and the library handles POSIX signals and safe pipes/redirects.
The single runtime dependency is termcolor, and the package is pure Python with low install friction. It targets Python 3.10+ and runs on CPython and PyPy. The API is designed for ease of integration—spinners can be controlled manually via start/stop or automatically via context manager, and the library provides methods like .write() to emit messages without colliding with the spinner animation.
Use it for
- Display progress feedback during file downloads, API calls, or database queries in CLI tools.
- Wrap long-running data processing functions with a decorator to show activity without modifying the function body.
- Provide visual feedback in scripts that perform batch operations or system administration tasks.
- Integrate with prompt-toolkit or other terminal UI libraries to show background task progress.
- Log operation milestones (via .write()) while keeping the spinner animated in the foreground.
- Create custom spinner animations by defining frame sequences and intervals for domain-specific indicators.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need a lightweight, low-friction terminal spinner for CLI tools or scripts.
The library is mature (Production/Stable), has no security vulnerabilities, and integrates easily via context manager or decorator. However, maintenance is aging (251 days since last release), so consider this if you need active bug fixes or Python version support updates; for stable, fire-and-forget use cases it is reliable.
Install
yaspin on PyPI
Before you install
Low friction: pure Python wheel with a single runtime dependency (termcolor). Maintenance status is aging—last release was 251 days ago and the repo shows no recent activity, though it remains archived=false with 915 stars and no known vulnerabilities.
Requires Python 3.10 or later (supports 3.10, 3.11, 3.12, 3.13, 3.14). Terminal must support ANSI escape sequences for spinner animation.
License in practice
MIT license (permissive) imposes no restrictions on use, modification, or distribution in proprietary or open-source projects.
Quickstart
pip install yaspin
import time
from yaspin import yaspin
with yaspin(text="Loading") as spinner:
time.sleep(2)
spinner.ok("✅")Verify before relying
- Whether aging maintenance status (251 days since last release) affects compatibility with newer Python patch versions or terminal emulators.
- Performance characteristics when used with very high-frequency spinner updates or in resource-constrained environments.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <4.0,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagetermcolor |
| Maintenance | Aging 251 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 6,249,241 / month, #1,947 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleEnvironment :: MacOS XEnvironment :: Other EnvironmentIntended Audience :: DevelopersIntended Audience :: End Users/DesktopIntended Audience :: Other AudienceIntended Audience :: System AdministratorsLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishOperating System :: MacOS :: MacOS XOperating System :: POSIX :: LinuxProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: ImplementationProgramming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Software DevelopmentTopic :: Software Development :: Libraries :: Python ModulesTopic :: Software Development :: User InterfacesTopic :: System :: LoggingTopic :: System :: MonitoringTopic :: System :: ShellsTopic :: TerminalsTopic :: Utilities |
Evidence: yaspin-3.4.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 › “CLI progress bar alternative”
- yaspinYaspin displays an animated terminal spinner to indicate progress…
- progressProvides terminal progress bars and spinners for displaying task…
- progressbar2progressbar2 renders text-based progress bars in the terminal,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also spinners · halo · progress · click-spinner · alive-progress · progressbar2 · ascii-colors · cursor · enlighten · pastel