Build cross-platform user interfaces with a simple Python API. Textual combines modern Python features with web development best practices, delivering an efficient cross-platform application development experience.

• 🖥️ Dual Rendering Engine - Write once, deploy to both terminal and web browsers
• 🧩 50+ Built-in Widgets - Buttons, tables, tree views and more out-of-the-box
• 🎨 Theme System - Multiple built-in UI themes with custom styling support
• 🛠️ Developer Tools - Real-time terminal app debugging
• ⚡ Async Core - Native async/await support

Want some more examples? See the examples directory.

• Python 3.10+
• Terminal requirements: TrueColor-supported terminal (e.g. Windows Terminal, iTerm2)

Install Textual via pip:

pip install textual textual-dev 

For development tools:

pip install "textual[dev]" 

""" An App to show the current time. """ from datetime import datetime from textual.app import App, ComposeResult from textual.widgets import Digits class ClockApp(App): CSS = """  Screen { align: center middle; }  Digits { width: auto; }  """ def compose(self) -> ComposeResult: yield Digits("") def on_ready(self) -> None: self.update_clock() self.set_interval(1, self.update_clock) def update_clock(self) -> None: clock = datetime.now().time() self.query_one(Digits).update(f"{clock:%T}") if __name__ == "__main__": app = ClockApp() app.run()

Textual's library of widgets covers everything from buttons, tree controls, data tables, inputs, text areas, and more… Combined with a flexible layout system, you can realize any User Interface you need.

Predefined themes ensure your apps will look good out of the box.

Run the following command to see a little of what Textual can do:

python -m textual 

Or try the textual demo without installing (requires uv):

uvx --python 3.12 textual-demo

How do you debug an app in the terminal that is also running in the terminal?

The textual-dev package supplies a dev console that connects to your application from another terminal. In addition to system messages and events, your logged messages and print statements will appear in the dev console.

See the guide for other helpful tools provided by the textual-dev package.

Textual apps have a fuzzy search command palette. Hit ctrl+p to open the command palette.

It is easy to extend the command palette with custom commands for your application.

Textual apps are equally at home in the browser as they are the terminal. Any Textual app may be served with textual serve — so you can share your creations on the web. Here's how to serve the demo app:

textual serve "python -m textual" 

In addition to serving your apps locally, you can serve apps with Textual Web.

Textual Web's firewall-busting technology can serve an unlimited number of applications.

Since Textual apps have low system requirements, you can install them anywhere Python also runs. Turning any device into a connected device. No desktop required!

Join the Textual developers and community on our Discord Server.