# beeware/briefcase

Tools to support converting a Python project into a standalone native application.

Repository: https://github.com/beeware/briefcase
Canonical: https://ross.abutalabs.com/products/briefcase
Homepage: https://briefcase.beeware.org/
Language: Python
License: BSD-3-Clause
License Family: permissive
Topics: application, python
Last push: 2026-08-24T08:01:18+00:00

## Health v2 (maintenance only)
Score: 93/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 80, longevity 100
- inputs: {"age_days": 4054, "days_push": 9, "days_rel": 57, "gap_med": 57, "n_releases_24m": 12}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3335, forks 538 (observed 2026-08-28T04:07:56.741248+00:00)

## What it is
Briefcase is a Python tool that converts Python projects into standalone native applications for Mac, Windows, Linux, iOS, Android, and the web. It is part of the BeeWare suite and handles packaging, bundling, and installer creation.

## Use cases
- package a python project as a native mac app
- build a windows installer for my python app
- convert python code into an android app
- create a standalone linux appimage from python
- distribute a python gui application to end users
- package a python app for ios

## When to choose
- you want to ship a Python project as a standalone native application across desktop and mobile platforms
- you're using BeeWare/Toga or another Python GUI toolkit and need installers
- you want a single tool handling macOS, Windows, Linux, iOS, and Android packaging

## When to avoid
- you only need to distribute a Python library or CLI via pip rather than a native app
- you need highly customized native packaging beyond what Briefcase's templates support
- you're targeting platforms Briefcase doesn't support yet, like watchOS or wearOS

## Facets
- artifact type: cli-tool
- maturity: active
- function: deployment, build-tool, cli
- domain: developer-tools, cross-platform, mobile-development, desktop-applications
- platform: python, windows, cross-platform, cli
- tags: packaging, native-apps, installer, beeware, appimage, flatpak, pyodide, macos, linux, android, ios

## Member repositories
- beeware/briefcase (main) score 93

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:56.741248+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:41:07.713537+00:00, confidence not recorded.
  - readme: https://github.com/beeware/briefcase (fetched 2026-08-28T04:07:56.741248+00:00, sha 0a8b6ecf593c)
  - registry_pypi: https://pypi.org/pypi/briefcase/json (fetched 2026-08-29T09:35:00.714690+00:00, sha e3138f4f7dfa)
- Data as of 2026-08-30T08:39:29.467469+00:00.