Install GitFourchette¶

Install a pre-built package¶

Recommended: Install the Flatpak

flatpak install flathub org.gitfourchette.gitfourchette

flatpak run org.gitfourchette.gitfourchette

Or, grab a standalone AppImage from the releases.

(The AppImage is self-contained; your desktop environment theme will not apply to it.)
Unsupported, experimental Mac and Windows builds are also available.

This page also contains instructions to run from source.

Recommended Git version: 2.41 or newer¶

GitFourchette works by calling git commands for you, so Git must be installed on your system (unless you use the Flatpak version, which comes with Git built in).

GitFourchette integrates best with Git 2.41 or newer. If you have an older version of Git, some features may be missing. The oldest supported version is Git 2.34.

Tip

The Flatpak version comes with recent versions of Git and Git-LFS, so you don’t have to install them separately. You can still tell the Flatpak version to use your host system’s Git install, via Settings ‣ Git Integration.

How to set up GitFourchette from source¶

Using your system’s package manager¶

This method gives you the best integration with your desktop environment.

With your system’s package manager, install pygit2 (v1.14.1 or later), pygments and pyqt6:

Ubuntu 24.10+	`apt install python3-pygit2 python3-pygments python3-pyqt6.qtsvg`
Fedora 41+	`dnf install python3-pygit2 python3-pygments python3-pyqt6`
Arch Linux	`pacman -S python-pygit2 python-pygments python-pyqt6 qt6-svg`

git clone https://github.com/jorio/gitfourchette
cd gitfourchette
./run.sh

Note

We recommend pygit2 v1.14.1 or later.

You can substitute pyqt6 with pyside6 (version 6.9.0 or later). GitFourchette is compatible with both.

Pygments (syntax highlighting) and mfusepy (mount commits with FUSE) are optional dependencies.

Using pip¶

The only prerequisite to install GitFourchette from source with pip is Python 3.10 or newer, which already comes standard with most Linux distributions.

These two commands will install GitFourchette and its dependencies:

git clone https://github.com/jorio/gitfourchette
pip install -e gitfourchette[pyqt6,pygments,mfusepy]

Then, simply run: gitfourchette.

To uninstall, run: pip uninstall gitfourchette.

Note

In the pip install command, you can substitute pyqt6 with pyside6. GitFourchette is compatible with both.

If you install pyqt6 (or pyside6) using pip instead of your system’s package manager, your desktop environment’s native Qt styles (“themes”) might not be available in the application.

Pygments (syntax highlighting) and mfusepy (mount commits with FUSE) are optional dependencies.