1.5 KiB
Welcome
Welcome to the Textual framework documentation. Built with ❤️ by Textualize.io
Textual is a Python framework for building applications that run within your terminal. Known as TUIs (Text User Interfaces), such applications have a multitude of benefits:
- Quick to develop: Textual is a modern Python API.
- Low requirements: Run Textual apps anywhere with a Python interpreter, even single-board computers.
- Cross platform: The same code will run on Linux, Windows, MacOS and more.
- Remote: Fully featured UIs can run over SSH.
- CLI integration: Textual apps integrate with your shell and other CLI tools.
Textual TUIs are quick and easy to build with pure Python (not to mention fun).
Installation
You can install Textual via Pypi.
If you plan on developing Textual apps, then you can install textual[dev]. The [dev] part installs a few extra dependencies for development.
pip install textual[dev]
If you only plan on running Textual apps, then you can drop the [dev] part:
pip install textual
Textual CLI app
If you installed the dev dependencies, you have have access to the textual CLI command. There are a number of sub-commands which will aid you in building Textual apps. See the help for more details:
textual --help