chriskiehl/gooey

Gooey is a Python library that turns command-line programs into graphical applications, with a window, buttons, checkboxes, and file pickers, using just a single line of code. Normally, when someone writes a Python script that accepts options and arguments, non-technical users have to run it from a terminal (the black text window), which can be intimidating. Gooey removes that barrier entirely. The way it works is straightforward. Python scripts that accept arguments typically use a built-in tool called argparse, which defines what options the program accepts. Gooey reads those definitions at the moment the program runs and automatically builds a graphical window around them. A text field becomes a text input box, a yes/no flag becomes a checkbox, a list of choices becomes a dropdown menu, and so on. You add a single decorator, a one-line annotation, above your main function, and Gooey handles the rest. No need to learn a separate GUI framework. You would reach for Gooey when you have written a useful utility script but want to share it with teammates, clients, or users who are not comfortable with the command line. The README specifically calls out "around-the-office-style scripts" and anything "targeted at a non-programmer" as ideal use cases. It is less suited for tools meant to be piped together in a terminal workflow, or for polished end-user products where you want full design control. The library is written in Python and works with Python 3. It uses a GUI framework called WX under the hood. Installation is through pip, the standard Python package manager. It also supports internationalization, meaning the interface can be translated into different languages via configuration files. The full README is longer than what was provided.