Install GitFourchette¶

Ready-made builds¶

This is the easiest way to try out GitFourchette.

AppImage: <https://github.com/jorio/gitfourchette/releases>
Flatpak builds are in the works (Nov. 2024)

Note

The AppImage is self-contained; your desktop environment theme will not apply to the AppImage version.

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 PyQt6 and pygit2 (version 1.15.1 or later)

Ubuntu	`apt install python3-pygit2 python3-pyqt6`
Fedora	`dnf install python3-pygit2 python3-pyqt6`
Arch	`pacman -S python-pygit2 python-pyqt6`

git clone https://github.com/jorio/gitfourchette

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

Note

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

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]

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]

Note

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