How to create a GUI application with Python

3 open source Python GUI frameworks

Open source Python GUI frameworks
Image credits : 

Photo by Jen Wike Huger, CC BY-SA; Original photo by Torkild Retvedt

There comes a time in the journey of most any programmer when they are ready to branch out past the basic examples and start to build a graphical interface to their program.

In Python, the steps to get started with GUI programming are not terribly complex, but they do require the user to begin making some choices. By its nature as a general purpose programming language with interpreters available across every common operating system, Python has to be fairly agnostic as to the choices it presents for creating graphical user interfaces.

Fortunately, there are many options available for programmers looking to create an easy way for users to interact with their programs. Bindings exist for several UI frameworks on a variety of platforms, including those native to Windows, Mac, and Linux, and many that will work across all three.

Before we go any further, let me play devil's advocate for just a moment and ask: Does it really make sense for your application to have a traditional graphical user interface at all? For some programs, the answer is obvious. If your application is inherently graphical in nature, and is either optimized for or just makes sense to be run locally on a single machine, then yes, you probably should build a desktop GUI. Many times, this is made obvious by what you're designing.

But for more general purpose programs, don't count out either the command line or a web interface just yet. The command line offer many advantages—speed, remote access, reusability, scriptability, and control—which may be more important for your application's users than a graphical interface, and there are many libraries like Click, Cement, and Cliff that make it easier to design great command line programs.

Similarly, a web interface, even for a program meant to be run locally, might be an option worth considering, particular if you think your users may wish to host your application remotely, and projects like Django, Flask, or Pyramid all make this straightforward. You can even use a library like pywebview to put a thin wrapper around a web application in a more native GUI window.

Or you can use a framework like Pyforms to build a consistent experience across the web, command line, and desktop, all with a single code base.

Still sure you want to build a GUI? Great, here are three fantastic open source libraries to get you started.


PyQt implements the popular Qt library, and so if you are familiar with Qt development in another language, perhaps from developing native applications for KDE or another Qt-using desktop environment, you may already be familiar with Qt. This opens up the possibility of developing applications in Python which have a familiar look and feel across many platforms, while taking advantage of the tools and knowledge of the large Qt community.

PyQt is dual licensed under both a commercial and GPL license, not unlike Qt project itself, and the primary company supporting PyQt offers a license FAQ to help understand what this means for your application.


If there were a single package which might be called the "standard" GUI toolkit for Python, it would be Tkinter. Tkinter is a wrapper around Tcl/Tk, a popular graphical interface and language pairing first popularized in the early 90s. The advantage of choosing Tkinter is the vast number of resources, including books and code samples, as well as a large community of users who may be able to help you out if you have questions. Simple examples are easy to get started with and fairly human-readable.

Tkinter is available under the Python license, on top of the BSD license of Tcl/Tk.


WxPython brings the wxWidgets cross-platform GUI library from its native C++ to Python. WxPython is a slightly more modern approach to, which looks a little more native than Tkinter across different operating systems as it does not attempt to create its own set of widgets (although these can be themed to look much like native components). It's fairly easy to get started with as well, and has a growing developer community. You may need to bundle wxPython with your applications, as it is not automatically installed with Python.

WxPython uses the wxWindows Library License of its parent project, which is OSI approved.

These are not the only choices you have available to you, not even by a long shot. For more options, check out the "GUI programming in Python" page on the official Python Software Foundation wiki, where you will find dozens of other options. While beginners will want to look out for and probably avoid projects which are only partial implementations, or those longer actively maintained, you'll find plenty of good fits for a variety of situations.

While many of the options out there are for more traditional applications that take on the windowed look and feel of their parent desktop environment, there are also times when you may wish to do something completely different, for example, within a video game. There are great libraries for these situations too, like pygame and pyglet.

Do you have a favorite that we didn't mention here? Let us know in the comments below!


David Walser

Tkinter is very well documented as you mentioned, but rather limited, as Tk is, so it's fine for very simple interfaces but not much more. wxPython is much more capable is and is pretty good, but is rather poorly documented, so you just have to find your way with it.

Vote up!
Vote down!
Daniel Andersson

PySide is an LGPL alternative to PyQt. PySide has also recently been adapted by the Qt project and will enjoy first class status as an official Python binding for Qt.

wxWidgets is nice in many ways, but not Python 3 compatible and thus not really a viable alternative for new projects. A Python 3 rewrite under the name of Project Phoenix is underway, but has been so for several years by now without reaching announced production quality.

TkInter is part of the standard lib, but you do not have to look far to see core devs recommending alternatives.

After working with all these alternatives, I would say that PySide is the most interesting way forward at the moment. It will be interesting for the Python community to see how well the Qt project will take care of it.

Vote up!
Vote down!
Greg Krakow

I like Kivy framework for Python. You can use the same code to run in all environments: Windows, Android, iOS, OS X, Linux, etc.

Vote up!
Vote down!