Installation
Purpose: Install TAPA on your development machine.
When to use this: Setting up TAPA for the first time.
What you need
| Dependency | Version | Notes |
|---|---|---|
GNU C++ Compiler (g++) | 7.5.0 or newer | Required for software simulation and deployment |
| Xilinx Vitis | 2022.1 or newer | Not needed for software simulation — only required for RTL synthesis and deployment |
TAPA has been tested on the following operating systems:
| OS | Minimum version | Notes |
|---|---|---|
| Ubuntu | 18.04 | |
| Debian | 10 | |
| Red Hat Enterprise Linux | 9 | Derivatives (AlmaLinux 9+, Rocky Linux 9+) also supported |
| Amazon Linux | 2023 | |
| Fedora | 34 | Fedora 39+ may have minor issues due to C library changes and Vitis HLS incompatibility |
Install from release
curl -fsSL https://raw.githubusercontent.com/tuna/tapa/main/install.sh | sh -s -- -q
This installs the current stable release (0.1.20260319). With root
privileges, TAPA installs to /opt/tapa with symlinks in /usr/local/bin.
Otherwise it installs to ~/.tapa and adds itself to your PATH via your
shell profile.
TAPA's internal toolchain is being incrementally refactored to Rust for improved
performance and reliability. During this transition, we recommend staying on the
stable release (0.1.20260319) for production workloads. To try the latest
(potentially unstable) release instead, pass --beta:
curl -fsSL https://raw.githubusercontent.com/tuna/tapa/main/install.sh | sh -s -- -q --beta
To install a specific version:
curl -fsSL https://raw.githubusercontent.com/tuna/tapa/main/install.sh \
| TAPA_VERSION=0.1.20260319 sh -s -- -q
Releases are available at github.com/tuna/tapa/releases.
Install g++
Install g++ using the package manager for your OS.
Ubuntu / Debian
For Ubuntu 18.04 and newer, or Debian 10 and newer:
sudo apt-get install g++
RHEL / Amazon Linux
For Red Hat Enterprise Linux 9 and newer, derivatives like AlmaLinux 9 and newer and Rocky Linux 9 and newer, or Amazon Linux 2023:
sudo yum install gcc-c++ libxcrypt-compat
Fedora
For Fedora 34 and newer. Fedora 39 and newer may have minor issues due to system C library changes and Vitis HLS tool incompatibility.
sudo yum install gcc-c++ libxcrypt-compat
Verify installation
tapa --version
Building from source
For source builds (full toolchain requirements and build commands), see Building from Source.
If installation fails, see Common Errors for known issues.
Next step: Your First Run