Skip to content

linux-getting-started.md

Latest commit

 

History

History
94 lines (74 loc) · 1.87 KB

linux-getting-started.md

File metadata and controls

94 lines (74 loc) · 1.87 KB

Linux Getting Started Guide

This guide will help you get started with FastFlowLM on Linux, including setup for various distributions and NPU (Neural Processing Unit) support.

Supported Distributions

  • Ubuntu 24.04 LTS
  • Ubuntu 25.10
  • Arch Linux
  • Other (Generic Linux)

1. Prerequisites

  • amdxdna driver (included in kernel 7.0+, or via amdxdna-dkms)
  • NPU firmware version 1.1.0.0 or later
  • Python 3.8+
  • XRT stack from AMD

2. System Preparation

Ubuntu (24.04, 25.10)

1. Add the AMD XRT PPA (Required for NPU/XDNA)

The AMD XRT stack is a prerequisite for NPU support. Add AMD's PPA:

sudo add-apt-repository ppa:amd-team/xrt
sudo apt update

See amd-team/xrt PPA for details.

2. Install XRT and NPU Drivers

sudo apt install libxrt-npu2 amdxdna-dkms

3. Reboot

sudo reboot

4. Install FastFlowLM

sudo apt install ./fastflowlm*.deb

5. (NPU) Check memlock limit

  • Run: 
    ulimit -l
  • If not unlimited, add to /etc/security/limits.conf: 
    *    soft    memlock    unlimited
*    hard    memlock    unlimited
  • Reboot system

Building from Source

  1. Clone the repository: 
    git clone https://github.com/FastFlowLM/FastFlowLM.git
cd FastFlowLM
  2. Build: 
    cd src
cmake --preset linux-default
cmake --build --preset linux-default -j$(nproc)
cmake --install --preset linux-default

4. Validating NPU Setup

To validate your NPU setup, run:

flm validate

You should see output similar to:

[Linux]  Kernel: 7.0.0-rc1-00052-g27936bfca73d
[Linux]  NPU: /dev/accel/accel0
[Linux]  NPU FW Version: 1.1.2.64
[Linux]  Memlock Limit: infinity