Welcome to tuiify

Turn typed Python functions into full-screen terminal forms with tuiify.

Quickstart

Install tuiify and run your first interactive function.

Input types

Map Python annotations and defaults to form controls.

Using the form

Submit values, view results, and diagnose errors.

Limitations and security

Understand supported signatures and the trust model.

Start here

tuiify decorates a synchronous function with @interactive. Call the function with arguments to run it normally, or call it with no arguments to open a Textual form and receive the submitted result.

💡
tuiify supports str, int, float, bool, and typing.Literal[...] annotations. Review limitations and security before using other signature patterns.