Installation Guide
How to install FrameTrain on your system
macOS Installation
Security warning on first launch
Since FrameTrain isn't signed by Apple yet, a warning will appear. The app is completely safe – just follow the steps below.
Download & install
• Download the .dmg file
• Open the .dmg file
• Drag FrameTrain into the Applications folder
Remove quarantine flag (Terminal)
Open Terminal (Applications → Utilities → Terminal) and run this command:
sudo xattr -cr "/Applications/FrameTrain.app"Enter your macOS password (it won't be shown as you type) and press Enter.
Launch the app
You can now open FrameTrain normally – just double-click the app in the Applications folder!
Why these steps?
macOS blocks apps from unverified developers. FrameTrain is open source and completely safe. We're working on official Apple signing for future versions.
Windows Installation
SmartScreen warning
Windows SmartScreen shows a warning because the app isn't verified by Microsoft yet. The app is safe – follow the steps below.
Download
• Download the .msi or .exe file
Open file properties
• Right-click the downloaded file
• Select "Properties"
• Go to the "General" tab
Unblock the file
In the "Security" section (at the bottom of the window):
• Check the "Unblock" checkbox
• Click "Apply" → "OK"
Start the installation
• Double-click the file
• If SmartScreen still appears: click "More info" → "Run anyway"
• Follow the installation wizard
Why this warning?
Windows SmartScreen protects against unknown apps. FrameTrain is safe and open source. We're working on official Microsoft signing for future versions.
Linux Installation
AppImage format
FrameTrain is distributed as an AppImage – portable and works on most Linux distributions.
Install FUSE (if needed)
On Ubuntu 22.04+:
sudo apt install libfuse2t64On Ubuntu 20.04:
sudo apt install libfuse2Download
Download the .AppImage file
Make it executable (GUI)
• Right-click the .AppImage file
• Select "Properties"
• Go to the "Permissions" tab
• Enable "Allow executing file as program"
• Click "OK"
Make it executable (Terminal)
chmod +x FrameTrain.2_1.0.1_amd64.AppImageAdjust the filename to match your downloaded file.
Launch the app
• Double-click the .AppImage file
Or via Terminal:
./FrameTrain.2_1.0.1_amd64.AppImageProblem: "Permission denied"?
If the AppImage is on an external drive, it must be mounted with exec:
sudo mount -o remount,exec /dev/sdX /mount/pointSystem Requirements
Operating system
macOS 11+ – Apple Silicon only (M1/M2/M3/M4)
Memory
8GB (16GB recommended)
Storage
10 GB free (50 GB+ recommended)
Python
3.8 or newer (required)
FrameTrain runs on PyTorch and will not start without Python 3.8+ installed – the first launch checks for it and aborts otherwise. On Windows you usually have to install Python yourself. PyTorch and all other packages are then installed automatically on first launch – only Python itself has to be present beforehand.
Download Python (python.org)The macOS build is for Apple Silicon (M1/M2/M3/M4) only. Intel Macs are not supported because the PyTorch stack no longer ships the required versions for Intel Macs.
Need help?