Chevron

Beautiful, modern interactive terminal prompts for Python.

Chevron is a modern prompt library for Python built on top of prompt_toolkit. It helps you build beautiful interactive command-line applications with a clean, intuitive API, rich terminal controls, and customizable themes.

Features

• 🎨 Modern terminal UI
• ⚡ Powered by prompt_toolkit
• 📝 Text input
• 🔒 Password input
• ✅ Confirmation prompts
• ☑️ Checkbox prompts
• 🔍 Interactive search prompt
• 📝 Built-in text editor
• 🎯 Consistent keyboard navigation
• 🌈 Theme support
• 🚀 Fast and lightweight

Installation

pip install chevron

Or with uv:

uv add chevron

Quick Start

from chevron import Input, Select, Confirm

name = Input("What's your name?").ask()

language = Select(
    "Favorite language",
    [
        "Python",
        "Rust",
        "Go",
        "Zig",
    ],
).ask()

remember = Confirm(
    "Remember your choice?"
).ask()

print(name)
print(language)
print(remember)

Available Prompts

Input

name = Input("Name").ask()

Password

password = Password("Password").ask()

Confirm

delete = Confirm(
    "Delete project?"
).ask()

Select

language = Select(
    "Language",
    [
        "Python",
        "Rust",
        "Go",
    ],
).ask()

Checkbox

languages = Checkbox(
    "Languages",
    [
        "Python",
        "Rust",
        "Go",
    ],
).ask()

Search

package = Search(
    "Search package",
    [
        "numpy",
        "pandas",
        "matplotlib",
        "torch",
    ],
).ask()

Editor

text = Editor(
    "Commit message"
).ask()

Themes

from chevron import Theme

theme = Theme(
    pointer="▶",
)

Input(
    "Name",
    theme=theme,
).ask()

Examples

Run the examples:

python examples/input.py
python examples/select.py
python examples/all.py

Roadmap

• Input
• Password
• Confirm
• Number
• Select improvements
• Checkbox improvements
• Search prompt
• Unit tests
• Async API
• Plugin system

Contributing

Contributions, ideas, bug reports, and pull requests are welcome.

License

MIT License.