CutiePy QT brand

FREQUENTLY ASKED QUESTIONS

CutiePy, answered

The questions developers ask before building their first Qt + Python desktop app with CutiePy. Still stuck? Ask on the forum.

What is CutiePy?

CutiePy is a Qt-first Python application shell for building polished desktop apps. It focuses on a smooth startup flow, widget-driven UI, embedded assets, and pragmatic developer tooling, rather than stuffing a web page into a window.

Which GUI toolkit does CutiePy use?

CutiePy is built around PySide6, the official Python bindings for Qt. It is designed for real desktop UX and native Qt widgets, not a browser wrapper.

Is CutiePy free to use?

Yes. CutiePy is free and open source. You can browse the code, clone the project, and start building on GitHub at github.com/tibberous.

What is the FlatLine debugger?

FlatLine is CutiePy's debugging companion for serious Python desktop work. It adds heartbeat-based freeze detection, crash snapshots, a recovery console, and parent-side process visibility so you can diagnose hangs and crashes quickly.

What does the application lifecycle look like?

CutiePy structures an app around clear lifecycle phases: build, initialize, validate, attach, and show. That keeps startup predictable and separates the bootstrapper from the running app.

Can I embed icons and assets in my app?

Yes. CutiePy is built to keep icons, SVGs, and image assets bundled with the app so deployment stays simple, and it can export theme colors and embedded assets to XML for preview, backup, and sharing.

How do I get started?

Clone the project, set up your Python environment, launch the sample app, and start iterating on a real Qt desktop shell instead of a blank window. The Docs and Examples sections walk through the pieces.

Where can I see code examples?

The Examples section shows polished desktop interactions like a branded startup window, theme XML export, and embedded assets. Python samples render with syntax highlighting right on the site.

Do I need to know Qt already?

It helps, but CutiePy is meant to give you a working, structured starting point. You build on top of PySide6 widgets and the provided lifecycle, so you spend less time wiring up boilerplate from scratch.

Where can I ask questions or get support?

Join the community on the CutiePy forum at forum.cutiepy.org, or reach out by email at admin@cutiepy.org. You can also use the contact form on the site.

Build something cute and fast

Grab the source on GitHub and spin up a real Qt desktop shell today.

View on GitHub