Repository navigation
Releases
Lamina 0.5.1
Changes in 0.5.1
Lamina now has installers. Each release gives an installer for each desktop
system, with the archives as before.
- Windows:
lamina-<version>-<arch>-setup.exe. It installs for the
current user only and adds Lamina to the Start menu. - macOS:
lamina-<version>-<arch>.pkg. It installsLamina.appin
/Applications. - Linux:
lamina-<version>-<arch>.deb. It installslaminaand
lamina-viewerin/usr/binand adds a desktop entry.
The tools and the file format did not change from 0.5.0.
Lamina 0.5.0
Changes in 0.5.0
The checks plan is complete: Lamina finds the board defects that KiCad finds,
defects that fab and assembly tools find, and defects that no layout tool
finds (wrong footprints, wrong labels, silent import losses).
New checks
- From KiCad:
via_count,courtyard_missing,courtyard_open,
weak_connection,track_zero_length,track_angle,zone_overlap,
mask_missing,silk_on_hole,silk_outside_board,silk_line_width,
text_variable.drill_sizeandannular_ringalso examine board holes. - Fab:
hole_to_edge,drill_aspect,mask_sliver,board_neck. - Assembly and BOM:
fiducial_count,part_to_edge,part_height,
paste_missing,paste_oversize,via_in_pad,testpoint_access,
bom_conflict,bom_part_number,tombstone(off by default). - Labels:
silk_under_part,label_far,label_pin,polarity_mark.
They read what the silkscreen says and compare it with the parts and nets. - Footprints:
footprint_mismatch,footprint_stale,footprint_changed,
footprint_unverified,footprint_symmetry,pin1_mark. - Electrical, with no schematic:
net_single_pad,pad_no_net,
track_current,voltage_clearance,decoupling_far,return_path. import_loss: data that an import dropped stays an open item.
New tools (84 in total)
verify_footprint,audit_footprints,compare_footprints: evidence for
each footprint, kept in the project.exportrefuses a board that has a
footprint with no evidence, ifforceis not true.board_minimums,fab_profiles,fab_compat: the smallest features of a
board against the limits of JLCPCB and PCBWay.use_fab_presetaccepts a
fab profile.review: one verdict before an order, with images, inoutput/review.md.apply_fixes: applies the fixes that the checks propose.add_area: a rule area for custom rules.
Other changes
- Custom rules select by item type (
kind), part and area, and have the values
hole_to_copper,courtyard_clearance,max_track_widthand
min_track_angle. The pours and the autorouter use them. - Command line:
lamina review,lamina diff, and
lamina check --format text|json|sarif|junit. - Fab output: one drill file for each span of blind or buried vias, a
.gbrjobfile, Gerber X2 net and part attributes on copper, BOM columns
Manufacturer and MPN, and the CPL position at the middle of the pads.
Parts that are not placed (DNP) get no paste. - KiCad: a
.kicad_drufile with the custom rules, rule areas in the two
directions, board cut-outs from footprint Edge.Cuts drawings. - A violation has
actual,requiredand, where one is safe, afix. - The analysis is faster: 0.3 s for the T.I.T example (before: 0.7 s).
Fixed
- A thermal spoke of a pour could go into a hole, a keep-out or a different
pour. Spokes now keep clear of all that the pour keeps clear of. - The autorouter put vias in SMD pads. It does not do that now.
starved_thermalcounted the spokes of one zone on one layer. It now counts
all the pours of a pad.- KiCad export: a custom rule with a smaller limit made KiCad miss errors of
the board limit.
Old boards
- The pours of a board can change: thermal spokes are cut where they went into
holes or keep-outs, and a pour keeps the voltage distance if nets have a
voltage. Export the fabrication files again. - A board with a footprint that has no evidence needs
audit_footprints,
verify_footprintorforce: trueto export. exportdoes not refuse blind and buried vias now.
Limits
- The voltage spacing table agrees with one secondary source for IPC-2221C.
It was not compared with the standard. Do not usevoltage_clearanceas the
only check for a safety distance. - The record of the work is in
docs/specs/checks-progress.md.
Lamina 0.4.0
Changes in 0.4.0
Checks that find more, and an export that refuses a board that is not complete:
- New check
hole_to_copper: a hole wall near copper of another net, and a
non-plated hole near copper. Before, a track through a mounting hole gave no
violation. Pours and the autorouter keep the same distance. - Texts and drawings on copper layers are checked as copper. Before, they were
in the Gerber files, but no check, pour or router saw them. exportrefuses a board with open connections or parts with no placement,
ifforceis not true. It always refuses blind and buried vias, because the
drill files have only through holes.- New tool
checks: each check with what it reports, why, its severity and the
rule fields that set its limits.checkhasrelease: trueto see the board
asexportsees it, andstatushasrelease_errors. lamina checkhas--release,--fail-onand--rules, and exit code 2 on
violations, for use in CI.- The model checks (for example
pin_role) accept severities and exclusions.
Checks of data that is not valid stay errors. New checkzone_outline: a
zone or board outline that is not valid gives a violation and does not stop
the program. - A violation has
actualandrequiredvalues where a check compares a
number with a limit (first inhole_to_copper). - KiCad import keeps the keep-out zones of a footprint (antenna areas) and the
paste and mask openings that a footprint has as pads with no copper. The
KiCad export writes footprint keep-outs. use_fab_presetkeeps the custom rules, exclusions and severities.strictcounts violations that have the same key, so a second free track
end is refused.
Fixed in the examples: examples/tit-flight-computer had no paste on the
ground pad of the ESP32 module. Its antenna keep-out is now in the footprint.
Old boards: hole_to_copper is 0.2 mm for a board that does not set it. A pour
with a smaller clearance moves away from non-plated holes. A board with open
connections now needs force: true to export.
Not in this release: the other checks of docs/specs/checks-plan.md.
Lamina 0.3.0
Changes in 0.3.0
PCB layout and validation tools for AI agents:
- Structured custom rules select nets, net classes and copper layers. DRC,
pours and routing apply the resolved limits. - Configure DRC severities and exclude individual violations with recorded
reasons. New checks cover mask openings near zones, holes inside courtyards,
thermal spokes, silkscreen size/overlap/edge clearance, net lengths and pairs. - Measure total net track lengths and via counts with
net_lengths; configure
length and skew limits.board_statsreports dimensions, area, components,
pads, vias, drill sizes and track measurements. Both tools are read-only. - Define differential pairs in projects or modular sources, check their gap and
coupling, and route both nets from a centre path withroute_diff_pair. tune_lengthadds meanders to a selected segment and refuses disconnected
contacts or DRC errors.add_teardropsandremove_teardropsexpose the
existing copper operations through MCP.- KiCad exports include filled zones and a project footprint library. Existing
library table entries are preserved; conflicting library names refuse export. - Fabrication archives include an IPC-D-356 electrical test netlist.
Validation: 259 workspace tests passed, with one real-board overview test ignored.
Headless MCP tests cover routing, tuning, teardrops, statistics and fabrication.
On the reference board, all 192 IPC test-point records match KiCad's type, layer
access and coordinates. KiCad DRC on exported fills reports no unconnected items
or footprint-library warnings; other board warnings remain.
Measurement limits: lengths sum all track branches and exclude via depth;
length/skew and pair checks do not calculate delay or impedance. Pair checks
allow short corner/end tolerances. KiCad may produce different thermal warnings
when it refills zones. IPC validation is not certification by every fabricator.
Each archive has two programs, the README and the licence files:
lamina: the MCP server and the command line tool.lamina-viewer: the 2D and 3D viewer and editor.
| Platform | Archive |
|---|---|
| Windows x64 | x86_64-pc-windows-msvc.zip |
| Windows Arm64 | aarch64-pc-windows-msvc.zip |
| Linux x64 | x86_64-unknown-linux-gnu.tar.gz |
| Linux Arm64 | aarch64-unknown-linux-gnu.tar.gz |
| macOS Apple silicon | aarch64-apple-darwin.tar.gz |
| macOS Intel | x86_64-apple-darwin.tar.gz |
Each archive has a .sha256 file with its checksum.
Install
- Download the archive for your platform and extract it.
- Put the folder in a permanent location.
- Connect your MCP client to
lamina mcp. The README shows the commands for Claude Code and Codex.
Known limits
- The programs are not signed.
- On Windows, SmartScreen can show a warning. Click "More info", then "Run anyway".
- On macOS, remove the quarantine flag before the first start:
xattr -d com.apple.quarantine lamina lamina-viewer.
- On Linux, the viewer needs a Vulkan or OpenGL driver and an X11 or Wayland session. The Linux builds need glibc 2.35 or later.
Lamina 0.2.2
Changes in 0.2.2
Design rule check:
- New warning
silk_to_pad: silkscreen text or a silkscreen drawing is nearer to a pad with a mask opening than thesilk_to_padrule. It checks board items and footprint items on both sides. A footprint outline needs to clear only the mask openings of its own pads. - The Checks list in the viewer shows the warning. Click a row to zoom to the pad.
Each archive has two programs, the README and the licence files:
lamina: the MCP server and the command line tool.lamina-viewer: the 2D and 3D viewer and editor.
| Platform | Archive |
|---|---|
| Windows x64 | x86_64-pc-windows-msvc.zip |
| Windows Arm64 | aarch64-pc-windows-msvc.zip |
| Linux x64 | x86_64-unknown-linux-gnu.tar.gz |
| Linux Arm64 | aarch64-unknown-linux-gnu.tar.gz |
| macOS Apple silicon | aarch64-apple-darwin.tar.gz |
| macOS Intel | x86_64-apple-darwin.tar.gz |
Each archive has a .sha256 file with its checksum.
Install
- Download the archive for your platform and extract it.
- Put the folder in a permanent location.
- Connect your MCP client to
lamina mcp. The README shows the commands for Claude Code and Codex.
Known limits
- The programs are not signed.
- On Windows, SmartScreen can show a warning. Click "More info", then "Run anyway".
- On macOS, remove the quarantine flag before the first start:
xattr -d com.apple.quarantine lamina lamina-viewer.
- On Linux, the viewer needs a Vulkan or OpenGL driver and an X11 or Wayland session. The Linux builds need glibc 2.35 or later.
Lamina 0.2.1
Changes in 0.2.1
Viewer, 2D:
- Pin names and nets on the pads, fitted to each pad. Net names on tracks.
- Net highlight (
`), single-layer mode (Shift+S), zoom keys (+ / -). - Rotate while you drag (R); a group turns about the part that you hold.
- Box selection by track segment; a crossing box takes what it touches.
- Copy and paste of tracks and vias (Ctrl+C / Ctrl+V).
- Routing modes (Shift+R): direct, walkaround and push, with a live preview. A track or part drag pushes other tracks aside in push mode.
- Differential pairs (Shift+D) with vias and matched lengths; length tuning with meanders ("tune to" in the inspector); teardrops (Board menu).
- The active copper layer is the bright one. Track width keys while routing (W / Shift+W).
Viewer, 3D:
- Zoom at the pointer; top, bottom and reset views; part bodies on or off (T / B / I / P).
- Hover and click parts; 2D and 3D share one selection.
Tools:
pins: the pads of a part with their pin names and nets. A rule check warns when a ground pin is on a power net, or the reverse.render:overview: trueadds a board overview with the close-up marked. In the 2D layers view,focuszooms to a pad or part.lamina-viewer shot(build with--features headless): the viewer without a window, for agents and tests.
Each archive has two programs, the README and the licence files:
lamina: the MCP server and the command line tool.lamina-viewer: the 2D and 3D viewer and editor.
| Platform | Archive |
|---|---|
| Windows x64 | x86_64-pc-windows-msvc.zip |
| Windows Arm64 | aarch64-pc-windows-msvc.zip |
| Linux x64 | x86_64-unknown-linux-gnu.tar.gz |
| Linux Arm64 | aarch64-unknown-linux-gnu.tar.gz |
| macOS Apple silicon | aarch64-apple-darwin.tar.gz |
| macOS Intel | x86_64-apple-darwin.tar.gz |
Each archive has a .sha256 file with its checksum.
Install
- Download the archive for your platform and extract it.
- Put the folder in a permanent location.
- Connect your MCP client to
lamina mcp. The README shows the commands for Claude Code and Codex.
Known limits
- The programs are not signed.
- On Windows, SmartScreen can show a warning. Click "More info", then "Run anyway".
- On macOS, remove the quarantine flag before the first start:
xattr -d com.apple.quarantine lamina lamina-viewer.
- On Linux, the viewer needs a Vulkan or OpenGL driver and an X11 or Wayland session. The Linux builds need glibc 2.35 or later.
Lamina 0.2.0
Changes in 0.2.0
- Providers: parts, footprints and 3D models come from providers. A part is
provider:id, for examplelcsc:C6186orkicad:LED_SMD:LED_0603_1608Metric. The tools areproviders,search_parts,import_partandimport_parts. The vendor-named tools are gone. - Part library: each download also goes into a library on your computer (
LAMINA_LIB,%LOCALAPPDATA%\lamina\libor~/.lamina/lib). Imports look in the project cache, then in the library, then online.lamina fetchfills the library before you work without a network. - Board formats and routers:
formats,import_board,export_board,routers,export_for_routerandimport_router_sessionreplace the format-named tools. - Fabrication:
fabricatorslists the outputs;exporttakes one by id. - 3D view:
rendercan focus a part, a pad or a region, zoom, hide parts and show only some parts. - Architecture: the core talks to the outside world through ports only. A new source, format or output is one type plus one line in
lamina-wiring.
Each archive has two programs, the README and the licence files:
lamina: the MCP server and the command line tool.lamina-viewer: the 2D and 3D viewer and editor.
| Platform | Archive |
|---|---|
| Windows x64 | x86_64-pc-windows-msvc.zip |
| Windows Arm64 | aarch64-pc-windows-msvc.zip |
| Linux x64 | x86_64-unknown-linux-gnu.tar.gz |
| Linux Arm64 | aarch64-unknown-linux-gnu.tar.gz |
| macOS Apple silicon | aarch64-apple-darwin.tar.gz |
| macOS Intel | x86_64-apple-darwin.tar.gz |
Each archive has a .sha256 file with its checksum.
Install
- Download the archive for your platform and extract it.
- Put the folder in a permanent location.
- Connect your MCP client to
lamina mcp. The README shows the commands for Claude Code and Codex.
Known limits
- The programs are not signed.
- On Windows, SmartScreen can show a warning. Click "More info", then "Run anyway".
- On macOS, remove the quarantine flag before the first start:
xattr -d com.apple.quarantine lamina lamina-viewer.
- On Linux, the viewer needs a Vulkan or OpenGL driver and an X11 or Wayland session. The Linux builds need glibc 2.35 or later.
Lamina 0.1.0
Each archive has two programs, the README and the licence files:
lamina: the MCP server and the command line tool.lamina-viewer: the 2D and 3D viewer and editor.
| Platform | Archive |
|---|---|
| Windows x64 | x86_64-pc-windows-msvc.zip |
| Windows Arm64 | aarch64-pc-windows-msvc.zip |
| Linux x64 | x86_64-unknown-linux-gnu.tar.gz |
| Linux Arm64 | aarch64-unknown-linux-gnu.tar.gz |
| macOS Apple silicon | aarch64-apple-darwin.tar.gz |
| macOS Intel | x86_64-apple-darwin.tar.gz |
Each archive has a .sha256 file with its checksum.
Install
- Download the archive for your platform and extract it.
- Put the folder in a permanent location.
- Connect your MCP client to
lamina mcp. The README shows the commands for Claude Code and Codex.
Known limits
- The programs are not signed.
- On Windows, SmartScreen can show a warning. Click "More info", then "Run anyway".
- On macOS, remove the quarantine flag before the first start:
xattr -d com.apple.quarantine lamina lamina-viewer.
- On Linux, the viewer needs a Vulkan or OpenGL driver and an X11 or Wayland session. The Linux builds need glibc 2.35 or later.