beaupy

library3.11.0pypypi✓ verified 84d ago

A library for building interactive terminal user interfaces (TUIs) in Python. Current version 3.11.0, supports Python 3.7.8 to <4.0.0. Released under MIT license. Active development with frequent releases.

web-framework

pip install beaupy

github ↗package ↗

INSTALL

IMPORT

SIG · BEAUPY

beaupy

web-frameworkpythonv3.11.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

beaupy

✓ import beaupy

✗ from beaupy import *

Avoid star imports; use specific functions like beaupy.confirm()

Ask for user input and confirmation using beaupy.

import beaupy name = beaupy.prompt("What is your name?") print(f"Hello, {name}!") if beaupy.confirm("Continue?"): print("Continuing...")

Debug

Known issues

gotchaSome functions like `select` and `select_multiple` do not work correctly in certain terminals if the terminal is not in raw mode. Ensure your terminal supports raw input.

fix

Use `beaupy.keys` for key handling or set environment variable `BEAUPY_RAWMODE=0` to disable raw mode.

affects: <3.11.0

deprecatedThe `beaupy.prompt_int` and `beaupy.prompt_float` functions are deprecated in favor of `beaupy.prompt` with type validation.

fix

Use `beaupy.prompt(..., validator=int)` or `beaupy.prompt(..., validator=float)` instead.

affects: >=3.8.0

breakingIn version 3.0.0, the internal refactoring moved several functions. `beaupy.select` now returns the selected item directly instead of a tuple.

fix

Update code: `result = beaupy.select(options)` instead of `(result, index) = beaupy.select(options)`.

affects: >=3.0.0

Errors

Common errors & fixes

ImportError: cannot import name 'prompt_int' from 'beaupy'

prompt_int was removed in beaupy 3.8.0+.

fix

Use `beaupy.prompt('Enter number:', validator=int)` instead.

TypeError: 'str' object is not callable

Incorrect usage: `beaupy.select` expects a list, not a string.

fix

Ensure you pass a list of options: `beaupy.select(['a', 'b', 'c'])`.

Upgrade

Version history

3.11.0latest on PyPI · released Jan 8, 2026

Audit

Dependencies

richrequiredUsed for console styling and output

cursorrequiredUsed for terminal cursor control

Agent activity

12 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/petereon/beaupy ↗

packagehttps://pypi.org/project/beaupy/ ↗