KiCadAI
Deterministic toolkit that turns behavioral requirements into KiCad schematics and PCBs with checks.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Go 1.26.8 or newer - System packages:
protoc - Keys or accounts: OPENAI_API_KEY
download release binary and install
curl -L -o /tmp/kicadai https://github.com/dshills/KiCadAI/releases/download/v1.0.1/kicadai_v1.0.1_linux_amd64 && curl -L -o /tmp/SHA256SUMS https://github.com/dshills/KiCadAI/releases/download/v1.0.1/SHA256SUMS && mkdir -p ~/.local/bin ./bin && cp /tmp/kicadai ./bin/kicadai && cp /tmp/kicadai ~/.local/bin/kicadai && chmod +x ./bin/kicadai ~/.local/bin/kicadai
Where the README and reality differ
- README: bin/kicadai --output ./out/divider schematic example divider
What worked: v1.0.1 binary has no `schematic` command (unknown command schematic); used `generate-led-demo`, `inspect project`, `writer check`, `validate board` syntax from cli-reference - README: --output selects output project directory
What worked: generate-led-demo ignored --output and wrote ./led_indicator/ with only .kicad_sch+.kicad_pro, no .kicad_pcb
Check that it works
./bin/kicadai versionThe output should contain “"version": "1.0.1"”.
First thing to try
./bin/kicadai versionRun kicadai version to confirm the tool is installed.
What it does
- Turn behavioral requirements into KiCad projectsTested
How to use it
- Run
kicadai generate-led-demo --output <directory> --overwriteto generate an example LED project. - Open the generated
led_indicator.kicad_schfile in the output directory with KiCad.
- Run
- Write native KiCad schematic and PCB filesNot shown working
- Check designs with ERC and DRCNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 1 of 3 features work
- Works offline
macOS: the project says it runs there; pickfit hasn’t tried it.
Good for
- generate example divider schematic to output directory
- validate schematic IR request file
- run KiCad ERC and strict DRC validation
- place components and route PCB nets
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 31 Oct 2026
- Version 1.0.1
Differences the test machine hit
- README: Go 1.26.8+ and make build from source
In the test: downloaded prebuilt kicadai_v1.0.1_linux_amd64 release binary (SHA256 df262f84...) to ./bin/kicadai and ~/.local/bin/kicadai; no Go needed