Skip to main content

​
Installation

Get started with Flet by installing the package and setting up your development environment.

​
Requirements

Before installing Flet, ensure you have:
  • Python 3.10 or higher - Flet requires a modern Python version
  • pip or conda - Python package manager
You can check your Python version by running python --version in your terminal.

​
Install Flet

Choose your preferred package manager to install Flet: 
pip install flet
The flet[all] option includes additional dependencies for all Flet features. Use the basic flet package if you want a lighter installation.

​
Verify installation

Confirm that Flet is installed correctly: 
python -c "import flet as ft; print(ft.__version__)"
You should see the Flet version number printed to your terminal.

​
Platform-specific setup

​
Windows

No additional setup is required for Windows. Flet works out of the box.
1

Install Python

Download and install Python from python.org if you haven’t already.
2

Install Flet

Open Command Prompt or PowerShell and run:
pip install flet
3

Start building

You’re ready to create Flet apps on Windows!

​
macOS

Flet runs natively on macOS with no additional dependencies.
1

Install Python

Install Python using Homebrew (recommended):
brew install [email protected]
2

Install Flet

Open Terminal and run:
pip install flet
3

Start building

You’re ready to create Flet apps on macOS!

​
Linux

Flet works on most Linux distributions. Some systems may require additional packages.
1

Install system dependencies

On Ubuntu/Debian:
sudo apt-get update
sudo apt-get install -y python3-pip python3-dev
On Fedora/RHEL:
sudo dnf install python3-pip python3-devel
2

Install Flet

pip install flet
3

Additional libraries (if needed)

If you encounter issues running Flet apps, you may need these libraries:
sudo apt-get install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev

​
Development tools

While not required, these tools enhance your Flet development experience:

​
Code editor

We recommend using:
  • Visual Studio Code with the Python extension
  • PyCharm (Community or Professional)
  • Any editor with Python support and autocomplete

​
Virtual environment

Create an isolated environment for your Flet projects: 
# Create virtual environment
python -m venv flet-env

# Activate on Windows
flet-env\Scripts\activate

# Activate on macOS/Linux
source flet-env/bin/activate

# Install Flet
pip install flet
Using a virtual environment is recommended to keep your Flet projects isolated and avoid dependency conflicts.

​
Mobile development setup

To build and deploy Flet apps to mobile devices, you’ll need additional tools:

​
iOS development

  • macOS is required for iOS development
  • Xcode - Download from the Mac App Store
  • CocoaPods - Install with sudo gem install cocoapods

​
Android development

  • Android Studio or Android SDK command-line tools
  • Java Development Kit (JDK) version 11 or higher
You don’t need these tools for initial development. You can build and test Flet apps on desktop and web first, then add mobile deployment later.

​
Testing on mobile devices

During development, you can test your Flet app on mobile devices without building a full package:
  1. Install Flet app on your mobile device:
  2. Run your app with the --ios or --android flag: 
    flet run --ios your_app.py
  3. Scan the QR code displayed in your terminal with your device

​
Update Flet

Keep Flet up to date to access the latest features and fixes: 
pip install --upgrade flet

​
Next steps

Now that you have Flet installed, you’re ready to build your first app:

Quick start tutorial

Build an interactive counter app in minutes and learn the basics of Flet.

Build docs developers (and LLMs) love

Get started for freeTalk to us