Installation

Prerequisites

• Python 3.8+

• A Linux-based operating system (tested on Ubuntu)

• Git

Step 1: Clone the Repository

git clone https://github.com/IY2002/LaZagna.git
cd LaZagna

Step 2: Install System Dependencies

LaZagna requires certain system packages. Install them with:

make prereqs

This runs the install_apt_packages.sh script which installs the necessary system-level dependencies.

Step 3: Install Python Dependencies

pip install -r requirements.txt

The key Python dependencies include:

• lxml — XML processing for architecture files

• numpy — Numerical operations

• Pillow — Image processing

• psutil — System monitoring

• PyYAML — YAML configuration file parsing

Step 4: Build OpenFPGA

Build the full project (including OpenFPGA) using:

make all

For faster build times, use parallel processing:

make all -j4  # Uses 4 cores

Verifying the Installation

Run a simple test to verify everything is working:

python3 lazagna/main.py -f setup_files/simple_test.yaml -v

If the run completes without errors, your installation is successful.