Installing FuseSoC

FuseSoC is written in Python and runs on all major operating systems.

System Requirements

Before installing FuseSoC check your system requirements.

  • Operating System: Linux, Windows, macOS

  • Python 3.6 or newer. (The last version supporting Python 2.7 is FuseSoC 1.10.)

  • The Python packages setuptools and pip need to be installed for Python 3.

Installation under Linux

Note

Do not type the $ symbol shown in the instructions below. The symbol indicates that the command is to be typed into a terminal window. Lines not prefixed with $ show the output of the command. Depending on your system, the output might be different.

FuseSoC is provided as fusesoc Python package and installed through pip, the Python package manager. The steps below cover the most common installation cases. Refer to the pip documentation for more advanced installation scenarios.

FuseSoC, like all Python packages, can be installed for the current user, or system-wide for all users. The system-wide installation typically requires root permissions.

Installation for the current user

To install the current stable version of FuseSoC for the current user, open a terminal window and run the following command. If an older version of FuseSoC is found, this version is upgraded to the latest stable release.

$ pip3 install --upgrade --user fusesoc

Check that the installation worked by running

$ fusesoc --version
2.4.dev15+g23c0592

If this command works FuseSoC is installed properly and ready to be used.

If the terminal reports an error about the command not being found check that the directory ~/.local/bin is in your command search path (PATH), or perform a system-wide installation instead (see below).

System-wide installation

FuseSoC can be installed for all users on a system. This operation typically requires root permissions.

$ sudo pip3 install --upgrade fusesoc

Uninstalling FuseSoC

Use pip to remove FuseSoC from your system.

$ pip3 uninstall fusesoc

Installation under Windows

FuseSoC is provided as fusesoc Python package and installed through pip, the Python package manager. Python is not installed by default on Windows, so doing that is the first step. Install the latest version of Python, either from python.org or from the Windows store.

Open up a shell (cmd, powershell, gitbash etc.) and run:

$ python --version

If the output is something along the lines of Python 3.10.7, Python has been successfully installed.

Installation for the current user

To install the current stable version of FuseSoC for the current user, open a shell and run the following command. If an older version of FuseSoC is found, this version is upgraded to the latest stable release.

$ pip3 install --upgrade fusesoc

Check that the installation worked by running

$ fusesoc --version
2.4.dev15+g23c0592

If this command works FuseSoC is installed properly and ready to be used.

The fusesoc.exe file should be installed in the Python Scripts directory (example: C:/Users/youruser/AppData/Local/Python/Python310/Scripts) folder, which should have been automatically added to the search path (PATH) when Python was installed.

Uninstalling FuseSoC

Use pip to remove FuseSoC from your system.

$ pip3 uninstall fusesoc

Installation under macOS

You can use pip to install as same as Linux.

$ pip3 install --upgrade --user fusesoc