FuseSoC is written in Python and runs on all major operating systems.
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
pipneed to be installed for Python 3.
Installation under Linux¶
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 1.12.1.dev53+g58bbb86
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).
FuseSoC can be installed for all users on a system. This operation typically requires root permissions.
$ sudo pip3 install --upgrade fusesoc
pip to remove FuseSoC from your system.
$ pip3 uninstall fusesoc
Installation under Windows¶
Add Windows installation instructions.
Installation under macOS¶
Add macOS installation instructions.