# FPGAwars/apio

:seedling: Open source ecosystem for open FPGA boards

Repository: https://github.com/FPGAwars/apio
Canonical: https://ross.abutalabs.com/products/apio
Homepage: https://fpgawars.github.io/apio/docs/
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: apio, cli, icestorm, fpga, lattice, verilog, package, manager, python
Last push: 2026-09-02T17:02:31+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 98, longevity 100
- inputs: {"age_days": 3858, "days_push": 0, "days_rel": 13, "gap_med": 4.5, "n_releases_24m": 23}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1006, forks 167 (observed 2026-09-03T02:15:05.830092+00:00)

## What it is
Apio is an open-source command-line toolbox that simplifies FPGA development, providing commands to lint, simulate, build, and upload designs to FPGA boards. It manages toolchains and supports 3 FPGA architectures, 80+ FPGAs, and 80+ boards, with a companion VS Code IDE extension.

## Use cases
- set up an fpga toolchain for a lattice ice40 board
- build and upload verilog code to an fpga board
- simulate a verilog design from the command line
- lint my verilog source files
- manage fpga toolchain packages like icestorm
- get started with open source fpga development

## When to choose
- you develop for supported Lattice/iCE40 or other supported FPGA boards and want a simple, unified CLI workflow
- you want automatic toolchain installation and management instead of configuring open-source FPGA tools manually
- you want a VS Code IDE integration for FPGA projects

## When to avoid
- you target FPGA vendors or architectures not among the 3 supported ones
- you need vendor-specific proprietary toolchains like Vivado or Quartus
- you need a GUI-only workflow without any command-line usage

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, build-tool, package-manager, developer-tools, testing
- domain: developer-tools, hardware, embedded-systems
- platform: windows, python, cli
- tags: fpga, verilog, icestorm, lattice, fpga-development, hardware-description, open-fpga, simulation, synthesis, command-line, linux, macos

## Member repositories
- FPGAwars/apio (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:05.830092+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:13:41.191656+00:00, confidence not recorded.
  - readme: https://github.com/FPGAwars/apio (fetched 2026-09-03T02:15:05.830092+00:00, sha ec1b8c3785c7)
  - homepage: https://fpgawars.github.io/apio/docs/ (fetched 2026-08-29T13:13:20.899574+00:00, sha 001c99fcd4bd)
  - registry_pypi: https://pypi.org/pypi/apio/json (fetched 2026-08-29T13:13:20.931915+00:00, sha 12ae81aeffeb)
- Data as of 2026-08-30T08:39:29.467469+00:00.