pybondmachine

pybondmachine is the Python library designed to streamline the development of FPGA accelerators through the use of the BondMachine framework.

With this library you can:

(phase 1) Build a firmware starting from python code. You can use the BondMachine framework to create a neural network accelerator, or you can use the library to create a custom accelerator.
(phase 2) Interact with the firmware to perform low-latency inference or to use the custom accelerator.

Phase 1

Prerequisites

Python 3.6 or higher
pip
Vivado 2019.1 or higher (if you want to build the firmware)
Tensorflow (to train or load a model)
BondMachine framework (download it from here)

Install

pip3 install pybondmachine

Usage

imports

from pybondmachine.prjmanager.prjhandler import BMProjectHandler
from pybondmachine.converters.tensorflow2bm import mlp_tf2bm

Load your neural network model (or train it from scratch)

import tensorflow as tf
model = tf.keras.models.load_model(os.getcwd()+"/tests/model.h5")

Convert your neural network model for BondMachine

output_file = "modelBM.json"
output_path = os.getcwd()+"/tests/"

# dump the json input file for neuralbond, the BM module that will be used to build the firmware
mlp_tf2bm(model, output_file=output_file, output_path=output_path)

Create and initialize a BM project with the params you prefer

prjHandler = BMProjectHandler("sample_project", "neuralnetwork", "projects_tests")

prjHandler.check_dependencies()
prjHandler.create_project()

config = {
    "data_type": "float16",
    "register_size": "16",
    "source_neuralbond": output_path+output_file,
    "flavor": "axist",
    "board": "zedboard"
}

prjHandler.setup_project(config)

Build the firmware

prjHandler.build_firmware()

Phase 2

Prerequisites

Python 3.6 or higher
pip
Pynq (if you want to use the custom accelerator)
FPGA device

Load the predictor

from pybondmachine.overlay.predictor import Predictor

Set the model specs

model_specs = {
    "data_type": "fps16f6",
    "register_size": 16,
    "batch_size": 128,
    "flavor": "axist",
    "n_input": 4,
    "n_output": 2,
    "benchcore": True,
    "board": "zedboard"
}

Specify firmware name and firmware path

firmware_name = "firmware.bit"
firmware_path = "proj_zedboard_axist_fp16_6_expanded_01/"

Initialize the predictor

predictor = Predictor("firmware.bit", firmware_path, model_specs)

Load the data to be processed

predictor.load_data("proj_zedboard_axist_fp16_6_expanded_01/banknote-authentication_X_test.npy", 
                    "proj_zedboard_axist_fp16_6_expanded_01/banknote-authentication_y_test.npy")

Load the overlay i.e. program the FPGA Remember that it is necessary that you call predictor.load_data before loading the overlay

predictor.load_overlay()

Perform inference

status, predictions = predictor.predict()

Phase 1 details under the hood

This python package is basically a wrapper of the BondMachine helper tool. It allows you to create a project, to build the firmware and to convert a neural network model to a json file that can be used as input for the BondMachine framework. Or, if you prefer, you can use the library to create a custom accelerator. Under the hood, bmhelper create the project, modify all the parameters of the configuration files inside the project and it checks the dependencies. Indeed, you can use bmhelper from CLI if you have installed it. So, to use the python library bmhelper is necessary and you can get it from here: bmhelper under the section "Installation".

Metadata

Release files for pybondmachine 1.1.85

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pybondmachine 1.1.85
File	Size	Uploaded
pybondmachine-1.1.85.tar.gz	14.3 kB	Apr 25, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pybondmachine 1.1.85
File	Interpreter	ABI	Platform	Reset
pybondmachine-1.1.85-py3-none-any.whl 14.6 kB Apr 25, 2026	Python 3	none	any	Details

Total release size: 28.9 kB

Release files / pybondmachine-1.1.85.tar.gz

Download URL	pybondmachine-1.1.85.tar.gz
Size	14.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`7f7632f92e52f524311b759df2b8816801d4ee6072841a763b322a78b61cd580`
BLAKE2b-256 checksum How to use checksums	`807598f710c7ccf889fb0f71ecef68feb1b1433230e4da880ca89f2687781748`
Upload date	Apr 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.11`

Release files / pybondmachine-1.1.85-py3-none-any.whl

Download URL	pybondmachine-1.1.85-py3-none-any.whl
Size	14.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0d4e639d33617689f167e0e415bdeec3589fdaa83a0137d4bb8cbefd9b127e95`
BLAKE2b-256 checksum How to use checksums	`4189d709a0221e22a8282b93838d918c48016f3a273c3811c6613ab923740819`
Upload date	Apr 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.11`