curtsies

What it is and what it does

Curtsies is a terminal interaction library that wraps low-level terminal control to let you build interactive console applications with colored and styled text. It provides three main abstractions: FmtStr objects for ANSI-formatted strings, FSArray objects for composable grids of formatted text, and window objects (FullscreenWindow for alternate-screen mode like Vim, or CursorAwareWindow for history-preserving mode) that render those grids and capture keyboard input events.

The library depends on blessed for terminal capability detection and cwcwidth for character width calculation. It's designed for applications that need fine-grained control over terminal rendering—games, interactive REPLs, monitoring dashboards—without the complexity of a full TUI framework. The package has been actively maintained since 2013 and remains compatible with modern Python versions.

Use it for:

• Build interactive terminal games or demos that respond to keyboard input and render colored text grids.
• Create terminal-based monitoring dashboards or status displays with real-time updates.
• Develop interactive command-line tools with formatted output and user input handling.
• Add colored, styled output to REPL environments or debugging utilities.
• Render complex text layouts in fullscreen or scrolling terminal modes.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Curtsies provides a Python library for building interactive terminal applications with colored text, formatted strings, and fullscreen or history-preserving window modes, handling keyboard input and grid-based character rendering.

Yes, if you need a lightweight, permissively licensed library for interactive terminal UIs with colored text and keyboard input on POSIX systems. The low install friction, active maintenance, and lack of known vulnerabilities make it a safe choice. The Alpha status reflects the package's maturity rather than instability—it has been in use since 2013. Not suitable for Windows without additional compatibility work.

Install

curtsies on PyPI

pip install curtsies

uv add curtsies

poetry add curtsies

Installing curtsies

Before you install

Low install friction with a pure Python wheel. Actively maintained as of August 2026 with recent commits; development status is marked Alpha but the package has been stable since its 2013 release.

License in practice

MIT license (permissive) places no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart

pip install curtsies

from curtsies import FullscreenWindow, Input, FSArray
from curtsies.fmtfuncs import red, bold

with FullscreenWindow() as window:
    a = FSArray(window.height, window.width)
    a[0:1, 0:10] = [red(bold('Hello'))]
    window.render_to_terminal(a)
    with Input() as input_generator:
        for c in input_generator:
            if c == '':
                break

Requires Python 3.10 or later; POSIX operating system (Linux, macOS, BSD) based on classifier metadata.

Verify before relying

• Whether the package works reliably on non-POSIX systems (classifiers list only POSIX support).
• Current state of documentation at the linked readthedocs URL and whether examples remain functional.

Package facts

Evidence: curtsies-0.4.3-py3-none-any.whl

Tags

More Terminals packages