Skip to main content

Fenolite

Headless, agent-first PCB design automation in Python. Fenolite lets an engineer — or an AI coding agent — generate, open, verify, compare, convert and export printed-circuit-board projects from Python code or a JSON-speaking command line, without a GUI. KiCad is the first backend (its files, with kicad-cli as the verification oracle); a second backend for another major commercial format family follows.

Status: version 0.4. A design script becomes a KiCad project with a board and a schematic, for KiCad 9.0 and 10.0. The loop of the agent guide works on two-layer boards: the board is placed, routed by an external router, filled, checked by KiCad's own design-rule check and exported to fabrication files. The schematic is judged by KiCad's own electrical rules check, by its netlist and by its schematic parity test. Version 0.4 adds the agent guide inside the package, boards of up to 8 copper layers with stack-ups, shaped outlines, differential pairs, impedance and length rules, routing with planes, and the documents and drawings a manufacturer asks for. What was proved for this version, what waits for the next one, and the limits are in docs/release/v0.4.md (docs/release/v0.3.md, docs/release/v0.2.md and docs/release/v0.1.md for the versions before). Every Altium write is experimental: no write kind has the evidence to leave that state yet, and most Altium evidence is INFERRED or an author report.

Fenolite is the Portuguese word for phenolic board material — the laminate many of us etched our first circuit boards on.

Principles

  • Agent-first CLI. JSON on stdout when not attached to a terminal, a fixed envelope, typed errors, a small exit-code vocabulary, and writes only with --confirm (--dry-run shows the plan).
  • Evidence on every answer. Each result says how it was verified (see below). Nothing is claimed that was not checked.
  • No silent information loss. What Fenolite does not understand in a file is preserved, and a lossy operation stops unless explicitly allowed.
  • Small, exact model. Integer nanometres and microdegrees, stable ids, canonical JSON that diffs cleanly in Git.
  • Stdlib-only core. pip install fenolite installs no other package; heavier features are optional extras.
  • Your templates, not ours. Sheet frames and title blocks are generated from your own spec; Fenolite ships no organisation's templates, rules or libraries.

The model is described in docs/design-model.md; the CLI contract in docs/cli-contract.md.

What version 0.4 does

  • The schematic. fenolite build writes the schematic of the design beside the board, one sheet per module, which KiCad's ERC and parity test accept on 9.0 and 10.0 (docs/schematic.md).

  • Checks. fenolite check runs KiCad's ERC and DRC, compares the netlist of the schematic with the model and the board, and compares schematic and board without a tool (fenolite netlist, fenolite parity).

  • Tables and files. The bill of materials and the placement table (fenolite bom, fenolite pnp) are rendered through a column template that you write (docs/assembly.md). Fabrication files and review renders (fenolite export, fenolite render) are described in docs/exports.md, and fenolite manifest lists every design file and artefact with its SHA-256 and a state.

  • Small questions. diff, roundtrip, fmt, explain, restore, net, region, neighbors and pads answer one thing each, with paging and a concise form.

  • The layout is kept. A board edited in KiCad survives a rebuild, also when a module or a net is renamed, and fenolite sync --to-source writes the placements into the source tree (docs/lens.md).

  • The design script. Six more rule kinds (hole to hole, hole clearance, annular width, courtyard, silkscreen, creepage), exact quantities, typed interfaces, and your own drawing sheet and title block (docs/dsl.md, docs/sheet-templates.md).

  • Altium files are read. inspect, check, diff and equivalent take Altium documents, libraries and projects, read-only and without a tool (docs/altium.md, docs/equivalence.md), and fenolite analyze measures current capacity, clearance and creepage on a board (docs/analyses.md). What is proved of this, and one known defect, are in the release record.

  • Altium files are written. fenolite build --target altium writes the PCB document (stacks of up to 16 signal layers, blind and buried vias, texts, keep-outs, holes, polygons and the script's rules), the schematic documents per module, both libraries, the project file, an output job and the drawing sheet; fenolite check judges copper and parity on Altium input, equivalent --level 5 compares routing, and fenolite kit builds the Altium verification kit (docs/altium.md, docs/altium-kit.md). All of it is experimental: the release record says per file kind what is proved and what is missing.

  • The agent guide. fenolite guide prints the guide that ships in the package, fenolite skill install puts it where an agent finds it, fenolite init writes a starter project, and fenolite fetch freerouting installs the pinned router (docs/cli-contract.md).

  • Larger boards. 6 and 8 copper layers, stack-ups, outlines with arcs and cut-outs, holes, rule areas, board texts and dimensions, differential pairs, impedance targets, net lengths and meanders, via protection, net ties and waivers, placement rules and part heights (docs/dsl.md); route keeps plane nets to their planes and is bounded by --timeout, and fenolite ready says whether a project is electrically ready. What each change ships, and what waits for the next release, is in docs/release/v0.4.md.

  • Fabrication documents. fenolite export writes IPC-2581, ODB++, STEP, PDF and DXF, and fabrication and assembly drawings (docs/exports.md, docs/drawings.md); fenolite testpoints reports fiducials and test points.

Evidence labels

Label Meaning
KICAD-VERIFIED accepted by kicad-cli of the stated version, and the claim confirmed by its output
ORACLE-VERIFIED(<tool>) an independent parser or tool agreed
CORPUS-VERIFIED round-trip holds on public files listed in the corpus manifest
ALTIUM-VERIFIED(kit) confirmed by a native-tool acceptance run with archived results: a run of the verification kit that fenolite kit builds, checks and records (docs/altium-kit.md)
ALTIUM-VERIFIED(author-report) reported by the author from ordinary use; never enough for a release claim
INFERRED deduced from public documentation; a hypothesis in docs/hypotheses.md tracks it
UNKNOWN bytes or fields preserved without interpretation
UNVERIFIED default for anything new

A command's overall label is the lowest label of the steps it ran.

Install

pip install fenolite

It installs no other package. fenolite capabilities --json then says which external tools it found: kicad-cli (KiCad 9.0 or 10.0) for the checks, the fills and the exports, and a router. It runs on Linux, macOS and Windows.

The loop

The ten commands an agent runs, from an empty folder to fabrication files. They start from a starter project made of built-in parts and use the built-in router, so kicad-cli is the only tool they need; a real board is routed by an external router or by copper written in the script. fenolite guide start --text prints the agent guide, which explains each command and what to do when one fails (in this repository: src/fenolite/agent/skill/SKILL.md), and fenolite skill install copies it to where an agent reads skills:

fenolite capabilities --brief --json
fenolite init blink --confirm --json
fenolite build blink/design.py --out blink/build --dry-run --json
fenolite build blink/design.py --out blink/build --confirm --json
fenolite place blink/build --strategy grid --confirm --json
fenolite route blink/build --router direct --confirm --json
fenolite fill blink/build --confirm --json
fenolite check blink/build --json
fenolite export blink/build -o blink/fab --all --manifest --confirm --json
fenolite render blink/build -o blink/views --svg --png --confirm --json

Install for development

git clone <this repository>
cd fenolite
uv sync --extra dev
uv run fenolite --version
make check-fast   # lint, format, types, residue scan and the tests that need no external tool
make check        # everything, on parallel workers: the gate before a merge

Talk to it like an agent does:

uv run fenolite capabilities --json --fields tools          # what is installed here
uv run fenolite capabilities --text                         # the same, for humans
echo $?                                                     # 0 ok, 2 usage, 4 confirm, 5 findings …

Optional extras: geo (polygon booleans), kicad-ipc (live KiCad session), mcp (MCP server), oracles (Gerber re-parsers used in tests), dev. Routers need no extra: they run as separate programs.

Licence and provenance

Apache-2.0 (LICENSE, NOTICE). Format knowledge comes only from public sources; see LEGAL.md for the clean-room rules and CONTRIBUTING.md for how to contribute. Every CI run and every commit (after make hooks) passes a residue scan (tools/residue/) that blocks absolute paths, internal identifier shapes and known non-public files; see docs/provenance.md for the provenance rules. AI agents working in this repository: read AGENTS.md first.

Metadata

Release files for fenolite 0.4.0

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

Source distribution (sdist)

Source distribution for fenolite 0.4.0
File Size Uploaded Provenance Actions
fenolite-0.4.0.tar.gz 6.0 MB With provenance Details for fenolite-0.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for fenolite 0.4.0
File Interpreter ABI Platform Actions
fenolite-0.4.0-py3-none-any.whl Python 3 none any Details for fenolite-0.4.0-py3-none-any.whl

Total release size: 7.9 MB

Release files / fenolite-0.4.0.tar.gz

Download URL fenolite-0.4.0.tar.gz
Size 6.0 MB
Tags Source
SHA-256 checksum
How to use checksums
cdf095d7b8565ab2c5cdda4653576a0538e868e6ff1490f0681f961cf6e53c4d
BLAKE2b-256 checksum
How to use checksums
86543c3635538fb3db3633125efdf9029386dada5a2bc7613f87720ce5cacd5f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.

Transparency log

Release files / fenolite-0.4.0-py3-none-any.whl

Download URL fenolite-0.4.0-py3-none-any.whl
Size 1.9 MB
Tags Python 3
SHA-256 checksum
How to use checksums
7665acd320509b6809abc316e291a9bd8b92c6c27e22173569851bb4ff31b47e
BLAKE2b-256 checksum
How to use checksums
d17af310018601071bd613111b4b3ed17e7fe40cf4d689db67da1948ed019b6a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.

Transparency log

Security for fenolite 0.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for fenolite-0.4.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page