Wasabi

1.1.3 verified Tue May 12 auth: no python install: verified

Wasabi is a lightweight console printing and formatting toolkit designed by Explosion, the creators of spaCy. It aims to make console output more readable and visually appealing with minimal overhead. The library is currently at version 1.1.3 and is actively maintained, receiving regular updates often in conjunction with other Explosion projects.

pip install wasabi

Common errors

error ModuleNotFoundError: No module named 'wasabi' ↓

cause The 'wasabi' library is not installed in the current Python environment.

fix

pip install wasabi

error NameError: name 'Printer' is not defined ↓

cause The 'Printer' class was used without being explicitly imported from the 'wasabi' package.

fix

from wasabi import Printer p = Printer() p.text('Hello')

error AttributeError: module 'wasabi' has no attribute 'info' ↓

cause A method specific to an instantiated 'Printer' object (like 'info') is being incorrectly called directly on the 'wasabi' module, instead of on a 'Printer' instance.

fix

from wasabi import Printer p = Printer() p.info('This is an info message')

Warnings

breaking Wasabi dropped support for Python 3.5 and earlier versions starting from v1.1.0. Ensure your environment uses Python 3.6 or newer. ↓

fix Upgrade your Python interpreter to version 3.6 or higher.

gotcha The `Printer.fail()` method, when called with `exits=True` or `exits=1`, will terminate the script by calling `sys.exit()` after printing. This is useful for critical failures but can halt execution prematurely if not intended. ↓

fix Avoid `exits=True` in non-critical scenarios or wrap the call in a `try-except SystemExit` block if you need to catch the exit.

gotcha The `from wasabi import msg` object is a pre-configured `Printer` instance. If you need custom settings (e.g., `pretty=False`, different colors), you must instantiate `from wasabi import Printer` directly. ↓

fix Use `msg = Printer(pretty=False, ...)` for customized behavior instead of the global `msg` object.

gotcha Wasabi is designed to be lightweight and specific for console output by Explosion's projects. For highly complex or full-featured formatting needs, consider alternative, more general-purpose libraries. ↓

fix Evaluate your formatting requirements; for advanced table rendering, progress bars, or highly custom UI elements, other libraries may be more suitable.

breaking The `Printer` class no longer accepts the `hide_tags` argument. This functionality was removed in Wasabi v1.0.0. ↓

fix Remove the `hide_tags` argument from your `Printer` instantiation. If you previously used it to disable tags, consider alternative methods for managing tag display.

breaking The `Printer` constructor no longer accepts the `hide_tags` keyword argument. This argument was removed in `wasabi` v1.0.0 during a significant refactoring of the `Printer` class. ↓

fix Remove the `hide_tags` argument from the `Printer` constructor. If you intended to customize tag visibility, investigate the `tag_map` argument introduced in `wasabi` v1.0.0 as a replacement.

Install compatibility verified last tested: 2026-05-12

python os / libc status wheel install import disk

3.10 alpine (musl) wheel - 0.07s 18.0M

3.10 alpine (musl) - - 0.10s 18.0M

3.10 slim (glibc) wheel 1.5s 0.05s 19M

3.10 slim (glibc) - - 0.06s 19M

3.11 alpine (musl) wheel - 0.10s 19.9M

3.11 alpine (musl) - - 0.12s 19.9M

3.11 slim (glibc) wheel 1.6s 0.09s 20M

3.11 slim (glibc) - - 0.09s 20M

3.12 alpine (musl) wheel - 0.09s 11.8M

3.12 alpine (musl) - - 0.11s 11.8M

3.12 slim (glibc) wheel 1.5s 0.09s 12M

3.12 slim (glibc) - - 0.09s 12M

3.13 alpine (musl) wheel - 0.09s 11.5M

3.13 alpine (musl) - - 0.10s 11.4M

3.13 slim (glibc) wheel 1.4s 0.09s 12M

3.13 slim (glibc) - - 0.09s 12M

3.9 alpine (musl) wheel - 0.07s 17.5M

3.9 alpine (musl) - - 0.09s 17.5M

3.9 slim (glibc) wheel 1.7s 0.06s 18M

3.9 slim (glibc) - - 0.07s 18M

Imports

Printer
```
from wasabi import Printer
```
msg
```
from wasabi import msg
```
Pre-initialized Printer instance for quick use without custom configuration.

Quickstart last tested: 2026-04-24

Initializes a `Printer` instance to format and print messages with various styles (good, warn, fail, info, text) and includes dividers. It also demonstrates using the pre-initialized `msg` object.

from wasabi import Printer

# Instantiate a Printer for custom configuration
msg = Printer(pretty=True, hide_tags=False)

msg.text("Starting application...", icon="🚀")
msg.good("Configuration loaded successfully.")
msg.warn("API key not found, running in limited mode.")
msg.fail("Database connection failed.")

# Print a divider
msg.divider("Summary")

# Using the global 'msg' instance (pre-configured)
from wasabi import msg as default_msg
default_msg.info("Default printer message.")