KiCad Local Agent

A completely local KiCad assistant using Ollama and kicad-cli. It requires no OpenAI API key, ChatGPT subscription, hosted database, or paid server. Prompts and project files remain on your Mac.

One-time setup (macOS)

1. Install Homebrew from https://brew.sh.

2. Clone and enter the repository:

   git clone https://github.com/durveshpathak1989/kicad-local-agent.git
   cd kicad-local-agent
   

3. Run the installer:

   chmod +x setup-local.command start-local.command
   ./setup-local.command
   

The script checks or installs Ollama, Node.js, Python, and KiCad through Homebrew; installs UI dependencies; offers to download the free qwen2.5-coder:7b model; and builds the application.

Start and use

./start-local.command

Open http://localhost:3000. Confirm Ollama, KiCad CLI, and the reference design are available. Choose Populated ESP32 prototype for a deterministic non-empty reference artifact, Empty native structure for a fresh container, or Revise ESP32 reference for bounded changes to the bundled board. Select a model, enter an explicit request, wait for validation, and download the ZIP. Press Control-C in Terminal to stop the interface.

New-project mode always creates native KiCad files and a closed board outline. It intentionally leaves the circuit unpopulated until component pinouts, footprints, ratings, and connections are verified. It is an editable engineering starter, not an automatically completed PCB.

For circuit synthesis, provide manufacturer/datasheet HTTPS URLs and, when available, a clear schematic PNG or JPEG. The local pipeline performs a bounded web search, records source evidence, and uses the optional moondream:1.8b Ollama vision model to transcribe visible components and connections. It records unreadable or unsupported details as questions instead of inventing them.

Manual dependency setup

brew install ollama node python
brew install --cask kicad
ollama serve
ollama pull qwen2.5-coder:7b
cd ui
npm ci
npm run build

Then return to the repository root and run ./start-local.command.