# Textualize/textual

The lean application framework for Python.  Build sophisticated user interfaces with a simple Python API. Run your apps in the terminal and a web browser.

Repository: https://github.com/Textualize/textual
Canonical: https://ross.abutalabs.com/products/textual
Homepage: https://textual.textualize.io/
Language: Python
License: MIT
License Family: permissive
Topics: terminal, python, tui, rich, cli, framework
Last push: 2026-07-11T06:02:34+00:00

## Health v2 (maintenance only)
Score: 89/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 92, release rhythm 78, longevity 100
- inputs: {"age_days": 1973, "days_push": 53, "days_rel": 64, "gap_med": 4, "n_releases_24m": 84}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 37056, forks 1321 (observed 2026-08-28T04:12:01.292184+00:00)

## What it is
Textual is a Python framework for building text user interfaces (TUIs) with a simple, modern Python API, CSS-like styling, and a rich widget library. Apps run in the terminal and can also be served in a web browser, with built-in testing support and async integration.

## Use cases
- build a terminal dashboard in python
- create a tui app with widgets like tables and inputs
- run a python ui app in the browser
- build a cli tool with an interactive interface
- make a terminal app that works over ssh
- prototype a desktop-like ui without a gui toolkit

## When to choose
- you want rich terminal interfaces in pure Python
- you need the same app to run in terminal and web browser
- you want built-in testing and CSS-based styling for TUIs
- you need cross-platform UI with minimal dependencies

## When to avoid
- you need a native GUI with images and pixel graphics
- you are building a traditional web frontend with HTML/JS
- you need a simple one-shot script where a plain CLI suffices

## Facets
- artifact type: framework
- maturity: active
- function: ui-components, terminal-ui, web-framework, testing, cli
- domain: developer-tools, web-development, cross-platform
- platform: python, windows, browser, cli, cross-platform
- tags: tui, text-user-interface, widgets, css-styling, async, rich, web-apps, ssh-remote, command-line, linux, macos

## Member repositories
- Textualize/textual (main) score 89

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:12:01.292184+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:25:41.269490+00:00, confidence not recorded.
  - readme: https://github.com/Textualize/textual (fetched 2026-08-28T04:12:01.292184+00:00, sha d9a716f609f2)
  - homepage: https://textual.textualize.io/ (fetched 2026-08-29T07:47:23.863739+00:00, sha 85b9d5d26a41)
  - registry_pypi: https://pypi.org/pypi/textual/json (fetched 2026-08-29T07:47:23.876028+00:00, sha 5dd5e81d996e)
  - site_page: https://textual.textualize.io/FAQ (fetched 2026-08-29T07:47:23.873365+00:00, sha ea99d2f26451)
- Data as of 2026-08-30T08:39:29.467469+00:00.