Skip to main content

Fenolite

PCB automation in Python, for engineers and AI agents.

Create PCB projects from code, inspect KiCad and Altium files, and review designs in your browser. Use the Python library or a CLI with structured JSON results, explicit write plans and conversion loss reports.

PyPI version CI on main Python 3.11+ Apache 2.0

Get started · Documentation · Examples · What's in 0.5 · Get help

Fenolite's browser viewer showing the authored routed Blink board, copper layers and project navigation.

Actual Fenolite viewer, using a small example authored for this project. No KiCad or Altium installation is needed to view it.

Install

Requires Python 3.11+. It installs no other package. Heavier features are optional extras.

python -m pip install fenolite
fenolite capabilities --brief --json
fenolite init blink --confirm --json
fenolite build blink/design.py --out blink/build --confirm --json
fenolite view blink/build --serve

Open the local address printed by the viewer. You now have a PCB and a schematic built from blink/design.py, using the built-in component catalog. No external CAD libraries are needed. These commands create a new blink folder; use a fresh location.

This starter is a header, resistor and LED. It is an educational example; choose parts, ratings, placement and rules for your own circuit before manufacturing. For reviewed write plans, a standalone HTML export and routing, follow the quickstart.

Three ways to use Fenolite

Review a design in your browser

Open a KiCad or Altium project, board, schematic or library. Explore layers, highlight nets, measure geometry and navigate between documents. Export a standalone HTML page for review.

fenolite view board.kicad_pcb --serve
fenolite view Project.PrjPcb --export review.html --confirm --json

Animated Fenolite viewer demonstration: board selection and cross-probing to the matching schematic.

The animation uses Fenolite's authored Altium Blink fixture. See the viewer guide for supported items, 3D prerequisites and rendering limits.

Build from Python

Define components, connections, placement and copper in a versioned source file. Build a project that can also be opened in its CAD editor. Preserve board edits on rebuild and sync placements back to source.

from fenolite.dsl import Design, Net, Part, connect, mm

design = Design("led")
design.board(mm(30), mm(20))
r1 = Part("R1", "Fenolite:Resistor", footprint="Fenolite:Chip_0603", value="330")
d1 = Part("D1", "Fenolite:LED", footprint="Fenolite:Chip_0603", value="LED")
design.add(r1, d1)
connect(Net("LED_A"), r1[2], d1[1])
r1.place(mm(10), mm(10))
d1.place(mm(20), mm(10))

This small fragment illustrates the DSL, not a complete powered circuit. Start with the complete starter tutorial, then explore authored examples and the Python DSL.

KiCad's CLI provides ERC, DRC, zone fills and fabrication exports. Production routing uses an external router or copper declared in the script. The built-in direct router is for simple demonstrations.

Convert and compare projects

Convert between KiCad and Altium, or write a KiCad 10 project for KiCad 9. Review what was kept, changed or lost, with a readback comparison against the source.

fenolite convert board.PcbDoc --to kicad --out converted --dry-run --json
fenolite equivalent before.kicad_pcb after.kicad_pcb --level 5 --json

Conversions and Altium writes are experimental in 0.6. Lossy conversion requires explicit consent. Support depends on the constructs in the input; review the report and the resulting design. Read the conversion guide.

For AI agents

The same commands return structured JSON, typed errors, evidence labels and file receipts. A write can be previewed with --dry-run, then confirmed using its --plan identifier.

fenolite guide start --text
fenolite skill install --help

The package includes an agent guide and board-design practice pages. Agents can inspect parts, query nets and geometry, build, route, check and export using the same CLI as an engineer. See the agent guide and CLI contract.

Full build → fabrication command loop (requires KiCad CLI)

Use a fresh folder for this complete loop. The first six lines need no external CAD tool; fill, check, export and render require KiCad's CLI. The direct router is a demonstration router.

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

For fabrication exports, BOM and placement tables, see exports and assembly.

Support at a glance

Status: version 0.6. Python scripts build KiCad 9/10 PCB and schematic projects. The agent loop uses KiCad's ERC/DRC checks, the board engineering analyses and an MCP server; conversion supports KiCad/Altium and the older KiCad major. Altium writes, computed Altium pours and conversions are experimental. See the release scope and limits.

Workflow What you need Status in 0.6
Build the starter; inspect and view supported files Python 3.11+, browser for the viewer Shipped; format-specific rendering limits apply
KiCad project generation Python; KiCad 9 or 10 to open in the editor Shipped
KiCad ERC, DRC, fill and fabrication export kicad-cli 9 or 10 Shipped; engineering review still required
External routing A supported router and its prerequisites Freerouting and KiCadRoutingTools integrations
KiCad/Altium conversion and KiCad downgrade Requirements vary by direction Experimental; explicit loss report
Altium project generation Python; Altium for native validation Experimental

Linux, macOS and Windows are supported. Optional extras include geo for polygon operations and kicad-ipc for a live KiCad session. Since 0.6 the package includes the stdlib-only MCP server (fenolite mcp), script editing and image replies described in the MCP documentation. See installation and prerequisites.

The viewer, conversion, board panels, slots and review tools ship since 0.5; 0.6 adds the MCP server, the board engineering tools (analyses, tidy, reuse, silkscreen, test points, DRC gates) and the Python API. Native Draftsman writing and Embedded Board Arrays remain gated. Detailed scope and deferred checks are in the release record.

Help and contribute

Trying Fenolite on a public or self-authored example? Tell us what worked and where you got stuck. Ask a question or report a bug, including the version, command and error output. Keep private designs and personal paths out of public reports.

For development, clone the repository, run uv sync --extra dev and read CONTRIBUTING.md.

License

Apache-2.0. Format knowledge comes from public sources under the project's clean-room rules. Results carry evidence labels; detailed claims live in the evidence matrix.

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

Metadata

Release files for fenolite 0.6.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.6.0
File Size Uploaded Provenance Actions
fenolite-0.6.0.tar.gz 9.4 MB With provenance Details for fenolite-0.6.0.tar.gz

Built distribution (wheel)

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

Total release size: 12.2 MB

Release files / fenolite-0.6.0.tar.gz

Download URL fenolite-0.6.0.tar.gz
Size 9.4 MB
Tags Source
SHA-256 checksum
How to use checksums
003e161c4ad4b11dcfd3bb1a75db7c78f70affe6a21a37cb88946b2e6d7b7aef
BLAKE2b-256 checksum
How to use checksums
6236da855b5d1e4a294c1b80129e2456760f1bc3f0863308a7c25b3280387c9e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 29, 2026.

Transparency log

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

Download URL fenolite-0.6.0-py3-none-any.whl
Size 2.8 MB
Tags Python 3
SHA-256 checksum
How to use checksums
ed8c70da95821a67590d07dd41a7d88a8dafb01177eff03344de050bc1725f17
BLAKE2b-256 checksum
How to use checksums
388b7bca742de70a85096646e3c5ef99fc91ad215f89f9f3551ce0e1304947da
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 29, 2026.

Transparency log

Security for fenolite 0.6.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.6.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 29, 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