Skip to main content
The Python app is the legacy version of the Flashcard AI desktop client. The .NET 8 app is the recommended production version and receives active development. Use the Python app only if you have a specific need for it.

Prerequisites

  • Windows
  • Python 3.10+download here
  • pip (included with Python)
  • Node.js — used by the build script to read the version from package.json

Libraries

The Python app uses these core libraries:
LibraryPurpose
CustomTkinterModern UI framework
google-genaiGemini AI integration
PillowImage handling
google-api-python-clientGoogle Drive API

Run in development

cd appPython
pip install -r requirements.txt
python app.py

Build a standalone EXE

1

Navigate to the appPython directory

cd appPython
2

Run the build script

build_exe.bat
The script first ensures PyInstaller is available:
pip install pyinstaller opencv-python
Then it packages the app with:
pyinstaller --noconfirm --onefile --windowed --name "FlashcardAI" app.py
FlagEffect
--onefileBundles all Python dependencies into a single EXE
--windowedHides the console window at runtime
--noconfirmOverwrites previous build output without prompting
3

Locate the output

After the build completes, the script renames the output to include the version number. The final file is placed at:
appPython\dist\FlashcardAI-Python-v<version>.exe
The dist directory opens automatically when the script finishes.

How PyInstaller bundles the app

PyInstaller analyzes all imports in app.py, collects the Python interpreter, your code, and every dependency into a single compressed EXE. When the EXE runs, it extracts its contents to a temporary directory and launches the app — no Python installation is required on the target machine.

Build the .NET app

Build the recommended production Windows desktop app

Build the Android app

Build the React Native app as a release APK

Build docs developers (and LLMs) love