Repolode
beeware

beeware/briefcase

Briefcase packages a Python project into a standalone native application for Mac, Windows, Linux, iOS, Android and the web.

Stars
3,376
Forks
557
Open issues
162
Last commit
2 days ago

What is it?

Briefcase is a tool that converts a Python project into a standalone native application. It targets desktop platforms (Mac, Windows, Linux), mobile platforms (iPhone/iPad and Android), and the web, so a single Python codebase can be distributed as an installable app on each of them.

It is part of the BeeWare suite, which provides the UI toolkits and runtime pieces that Briefcase-built apps use. Installation is done with pip, and the project offers a tutorial that walks through creating and packaging a new application.

Support for Apple TV, watchOS and wearOS deployments is listed as planned rather than available.

Key features

  • 01Packages Python projects as native apps for Mac, Windows and Linux.
  • 02Builds installable apps for iPhone, iPad and Android.
  • 03Supports packaging for the web.
  • 04Installs with a single pip command.

Use cases

  • Shipping a Python desktop application to Windows, Mac and Linux users from one codebase.
  • Turning a Python app into an iOS or Android app without rewriting it.
  • Learning how to create and package a Python application through the BeeWare tutorial.

Quick start

  1. 1

    Install Briefcase with pip

    python -m pip install briefcase
  2. 2

    Follow the BeeWare tutorial to create and package an app

Things to know

  • Packaging for iOS, Android and the web depends on platform-specific toolchains and setup.
  • Support for AppleTV, watchOS and wearOS is only planned, not available.

In collections

Topics

FAQ

What is briefcase?
Briefcase packages a Python project into a standalone native application for Mac, Windows, Linux, iOS, Android and the web. Briefcase is a tool that converts a Python project into a standalone native application. It targets desktop platforms (Mac, Windows, Linux), mobile platforms (iPhone/iPad and Android), and the web, so a single Python codebase can be distributed as an installable app on each of them.
Is briefcase free to use? What license does it have?
briefcase is open source under the BSD-3-Clause license. Check the license terms before using it in commercial products.
Is briefcase still maintained?
Actively maintained. The last commit to briefcase was on Nov 6, 2026.
What can I use briefcase for?
Shipping a Python desktop application to Windows, Mac and Linux users from one codebase. Turning a Python app into an iOS or Android app without rewriting it. Learning how to create and package a Python application through the BeeWare tutorial.
How do I install briefcase?
Install Briefcase with pip: python -m pip install briefcase Follow the BeeWare tutorial to create and package an app
Where can I get briefcase?
The source code and installation instructions are on GitHub: https://github.com/beeware/briefcase

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects