zhoushoujianwork/easyeda-agent

What is easyeda‑agent?

easyeda‑agent is an AI‑powered automation layer for EasyEDA Pro (the professional version of the JLC EDA online design suite). It lets you talk to an AI assistant in natural language and have it read data sheets, create symbols/footprints, draw schematics, lay out PCBs, adjust silk‑screen, run DRC/DFM checks and finally save the design – all through the official eda.* API that EasyEDA exposes.

---

Core Capabilities

Area	What the agent can do
Library authoring	From a PDF or mechanical drawing it extracts part numbers, pin‑outs and package dimensions, then creates a complete Symbol, Footprint, Device (and optional 3‑D model) in your personal EasyEDA library, with evidence pages and validation before writing.
End‑to‑end board creation	Given a natural‑language requirement (e.g., “ESP32‑S3 minimal system, 4‑layer, USB‑C download, power‑rail, keep‑out for antenna”), the agent selects parts, builds the schematic, partitions the board, places components, routes traces, pours copper, generates silk‑screen and runs full DRC/DFM before saving.
Component standardisation	Scans an existing schematic, finds non‑standard parts, replaces them with exact LCSC C‑numbers or official footprints while preserving pin numbers, positions and the linked PCB instance.
Schematic clean‑up	Detects floating nets, shorts, cross‑page net names, NC pins, mismatched pin numbers, and can automatically re‑arrange the schematic and re‑run checks.
PCB layout & routing	Module‑aware auto‑placement, board‑outline fitting, rule‑aware short‑trace routing, via insertion, copper‑pour, 4‑layer power‑plane generation, antenna keep‑outs, etc.
Silk‑screen editing	Moves silk‑screen items away from pads, components and keep‑outs, adds board notes, connector names, LED polarity markers and even SVG logos.
Reuse of proven blocks	A built‑in library of common circuits (CH340, ESP32, power‑regulators, USB hubs, etc.) can be dropped into a design, wired automatically and reconciled with the schematic.
Verification & delivery	Generates BOM, netlist, manufacturing files, screenshots, audit logs and performs explicit saves after each step.

---

How to Use It

1. Install the EasyEDA CLI/daemon and the AI Skill with a one‑line script (install.sh for macOS/Linux or install.ps1 for Windows). The installer verifies checksums, sets environment variables and detects which LLM client (Codex, Claude, etc.) you have.
2. Add the connector to EasyEDA Pro from the JLC plugin market (or download the .eext file from the GitHub releases) and enable Allow external interaction in the EasyEDA settings.
3. Start the daemon: easyeda daemon start.
4. Talk to the agent – either via a supported chat client or by feeding a prompt to the Skill. Example prompts are provided in the README for creating a library from a PDF, building an ESP32‑S3 board, fixing silk‑screen, standardising components, or a full design audit.
5. The agent translates the request into typed actions that the CLI sends to the connector, which then calls the official eda.* API to read/write the project. Each action is guarded by pre‑checks and post‑read verification, and the daemon automatically saves the project after successful steps.

---

Installation Snapshot

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main/install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main/install.ps1 | iex

The scripts verify SHA‑256 checksums, install the CLI under $HOME/.local/bin (or %USERPROFILE%\.local\bin on Windows) and place the Skill files where the LLM client can load them.

---

Current Limits

• Routing: Fully dense, maze‑style auto‑routing still needs an external tool like Freerouting; the built‑in router handles short, clear connections.
• Undo: EasyEDA’s API lacks programmatic undo, so the agent relies on pre‑write guards, post‑read validation and explicit saves to keep the design safe.
• Impedance: The API cannot read all stack‑up parameters (dielectric constant, copper thickness), so the agent cannot guarantee impedance‑controlled traces automatically.
• PDF library creation: Works best when the PDF contains clear model numbers, pin tables and pad dimensions. Ambiguous or low‑quality scans will cause the agent to pause and ask for clarification.

---

Where to Learn More

• Quick‑Start Guide – docs/quick-start.md
• CLI Reference – docs/cli/schematic.md and docs/cli/pcb.md
• Feature List – docs/FEATURES.md
• Architecture & Protocol – docs/architecture.md / docs/protocol.md
• Showcase Projects – ESP32‑S3 4‑layer board, AS07‑M1101D SMA library creation, JLC PCB exam layout, etc.

---

License

MIT (with some Apache‑2.0 components for the beautify module).

---

TL;DR

easyeda‑agent lets an LLM act as a design assistant inside EasyEDA Pro: you describe what you want, it reads datasheets, builds libraries, draws schematics, places and routes PCBs, cleans up silk‑screen, runs checks and saves the result – all through a typed‑action API that keeps the workflow safe and auditable.