Install GitFourchette¶

Ready-made builds¶

This is the easiest way to try out GitFourchette.

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.)

Run from source using your system’s Qt libraries¶

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 libqt6svg6`
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

```
./gitfourchette/run.sh
```

Note

We recommend pygit2 v1.16.0 or later. However, GitFourchette will remain compatible with pygit2 v1.14.1, with a reduced feature set, at least until the current release of Ubuntu provides a newer version of pygit2.

You can substitute PyQt6 with PySide6. GitFourchette is compatible with both.

Pygments is an optional dependency.

Install from source with 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]

Then, simply run gitfourchette.

To uninstall:

pip uninstall gitfourchette

Note

If you prefer to use PySide6 instead of PyQt6, install GitFourchette with this command instead:

pip install -e gitfourchette[pyside6,pygments]

Note

Installing PyQt6 or PySide6 via pip instead of your system’s package manager may cause GitFourchette to ignore your desktop environment theme.

Pygments is an optional dependency.