fusesoc

library2.4.6pypypi✓ verified 86d ago

FuseSoC is a package manager and build abstraction tool for HDL (Hardware Description Language) code. Current version is 2.4.5, with a regular release cadence of several minor versions per year. It supports managing reusable HDL cores, generating simulation and synthesis build systems, and integrates with EDA tools.

workflow devops serialization

pip install fusesoc

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · FUSESOC

fusesoc

workflowpythonv2.4.6

Install

2.9s avg

Import

695ms

Disk

36MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.4.6 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.718s · 37.2MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.9s · import 0.672s · 38MB

36MB installed

● package 36MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

main

✓ from fusesoc.main import main

✗ import fusesoc

FuseSoC is primarily a CLI tool. Importing the top-level package directly does not expose the CLI function.

Run FuseSoC's help from Python. For CLI usage, invoke `fusesoc` directly.

from fusesoc.main import main import sys sys.argv = ['fusesoc', '--help'] main()

fusesoc --version

Debug

Known issues

breakingFuseSoC 2.4 migrated from setup.py to pyproject.toml. Projects relying on direct setup.py installation may break.

fix

Use `pip install fusesoc` or build from source with `pip install .` (pyproject.toml).

affects: >=2.4

deprecatedThe old CAPI1 core format is deprecated. Only CAPI2 (.core) files are actively supported.

fix

Convert .core files to CAPI2 format as documented in the official migration guide.

affects: >=2.1

gotchaRunning `fusesoc run` without specifying a target may fail if the core defines multiple targets. The first target is used by default, which may not be intended.

fix

Explicitly specify the target with `--target` flag, e.g., `fusesoc run --target=sim`.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'fusesoc'

FuseSoC is not installed or not in the current Python environment.

fix

Run `pip install fusesoc` in the correct environment.

fusesoc: error: unrecognized arguments: --work-root

Using --work-root flag with FuseSoC versions before 2.3.

fix

Upgrade to FuseSoC 2.3 or later, or use the legacy --work option.

ERROR: Could not find a version that satisfies the requirement fusesoc (from versions: none)

The Python version is too old (<3.6) or too new (>=4.0).

fix

Use Python 3.6 to 3.12.

Upgrade

Version history

2.4.6latest on PyPI · released May 10, 2026

Audit

Dependencies

edalizerequiredRequired for interfacing with EDA tools.

pyyamlrequiredRequired for parsing core files.

Agent activity

9 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/olofk/fusesoc ↗

packagehttps://pypi.org/project/fusesoc/ ↗

homepagehttps://fusesoc.net ↗

docshttps://fusesoc.readthedocs.io ↗

changeloghttps://github.com/olofk/fusesoc/blob/main/NEWS ↗