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.1. The loop below works on two-layer boards, for KiCad 9.0 and 10.0: a design script becomes a KiCad project that is placed, routed by an external router, filled, checked by KiCad's own design-rule check and exported to fabrication files. What was proved for this version, and its limits, are in docs/release/v0.1.md. The Altium target is experimental.

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. Fabrication files and review renders (fenolite export, fenolite render) are described in docs/exports.md.

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
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 a design script to fabrication files (agent/SKILL.md explains each one and what to do when one fails):

fenolite capabilities --json
fenolite build examples/blink_2layer/design.py --out build/blink --dry-run --json
fenolite build examples/blink_2layer/design.py --out build/blink --confirm --json
fenolite place build/blink --strategy grid --confirm --json
fenolite route build/blink --router freerouting --confirm --json
fenolite fill build/blink --confirm --json
fenolite check build/blink --json
fenolite export build/blink -o build/blink/fab --all --manifest --confirm --json
fenolite render build/blink -o build/blink/views --svg --png --confirm --json
fenolite inspect build/blink/blink.kicad_pcb --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.1.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.1.0
File Size Uploaded Provenance Actions
fenolite-0.1.0.tar.gz 2.3 MB With provenance Details for fenolite-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 3.0 MB

Release files / fenolite-0.1.0.tar.gz

Download URL fenolite-0.1.0.tar.gz
Size 2.3 MB
Tags Source
SHA-256 checksum
How to use checksums
17db9a21402a9e14dc7c79098e09cd4dba545b0558c0b2580aa1b202bc62c4db
BLAKE2b-256 checksum
How to use checksums
2f70e533e0da2e3d59c5e29096f8af8adde3a3cd47ae6dd0eff72a9717393402
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 5, 2026.

Transparency log

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

Download URL fenolite-0.1.0-py3-none-any.whl
Size 705.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9e2d01e617133bf287c52b7b364c34390b02428f4d7c1081c85161acd75ad523
BLAKE2b-256 checksum
How to use checksums
e02c617f182d01d98b433bac979a94896922d42f1cb8684594e8f2862361e8d7
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 5, 2026.

Transparency log

Security for fenolite 0.1.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.1.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 5, 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