feat: initial scaffold with datasheet extractor, QFN/QFP, SKiDL, KiCad integration and custom license

Author: assalas

.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .[test]
+      - name: Run tests
+        run: |
+          pytest -q

.gitignore

@@ -0,0 +1,20 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+*.egg-info/
+.venv/
+.env
+
+# Build
+build/
+dist/
+
+# IDE
+.vscode/
+.idea/
+
+# Tests
+.pytest_cache/
+.cache/

LICENSE

@@ -0,0 +1,22 @@
+Custom Non-Commercial License with Enterprise Authorization Requirement
+
+Copyright (c) 2025, PCB Designer AI Agent Authors
+All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to use, copy, modify, merge, publish, and distribute the Software for non-commercial purposes, subject to the following conditions:
+
+1) Non-Commercial Use Only: The Software may be used solely for personal, educational, research, or non-profit purposes. Any use of the Software by a company, enterprise, organization, or for any commercial purpose requires prior written authorization from the copyright holder.
+
+2) Attribution: You must retain the above copyright notice and this permission notice in all copies or substantial portions of the Software.
+
+3) Notice of Modifications: If you modify the Software, you must include a prominent notice stating that you have changed the files.
+
+4) No Warranty: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+5) Enterprise/Commercial Authorization: Companies, enterprises, or any for-profit entities wishing to use the Software must obtain prior written authorization from the copyright holder. To request authorization, contact: YOUR_EMAIL_HERE. Terms may include licensing fees or additional conditions.
+
+6) Contributions: By submitting a contribution to this project, you agree that your contribution is provided under the same terms as this license unless you explicitly state otherwise in the contribution.
+
+7) Trademarks: This license does not grant permission to use the trade names, trademarks, service marks, or product names of the copyright holder, except as required for reasonable and customary use in describing the origin of the Software and reproducing the content of this notice.
+
+END OF TERMS

README.md

@@ -0,0 +1,104 @@
+# PCB Designer AI Agent
+
+An open-source agentic pipeline that turns a natural-language hardware description into a manufacturable PCB. The system automates:
+
+1) Requirement → Component selection (BOM)
+2) Datasheet retrieval → Footprint extraction → Footprint generation (.kicad_mod)
+3) Schematic synthesis (netlist) from component reference designs and constraints
+4) PCB placement and routing (via KiCad + Freerouting or vendor tools adapters)
+5) Gerber generation via EDA tool backends (KiCad first-class; adapters for Altium/Cadence planned)
+
+Status: early scaffold. Includes a working, parametric KiCad footprint generator for common packages and an extensible pipeline with clear interfaces for each step.
+
+## Why
+- Speed up concept-to-board by automating tedious steps.
+- Keep humans-in-the-loop for safety while leveraging LLMs/CV for datasheet understanding.
+- Vendor-neutral core with adapters for popular EDA tools.
+
+## Architecture
+- Core config + logging
+- Pluggable LLM providers (OpenAI/Ollama/etc.)
+- Steps:
+  - requirements_parser → bom_generator → datasheet_fetcher → footprint_generator → schematic_synthesizer → pcb_router → gerber_exporter
+- Backends:
+  - KiCad backend (first-class, CLI-friendly)
+  - Adapters for Altium (COM/Script/PDN) and Cadence Allegro (SKILL/CLI) planned
+
+```text
+pcb-designer-ai-agent/
+├─ README.md
+├─ LICENSE
+├─ pyproject.toml
+├─ .gitignore
+├─ src/pcbai/
+│  ├─ __init__.py
+│  ├─ core/
+│  │  ├─ config.py
+│  │  └─ logger.py
+│  ├─ llm/
+│  │  ├─ provider.py
+│  │  └─ providers/
+│  ├─ steps/
+│  │  ├─ requirements_parser.py
+│  │  ├─ bom_generator.py
+│  │  ├─ datasheet_fetcher.py
+│  │  ├─ footprint_generator.py   <-- working generator for SMD R/C and SOIC
+│  │  ├─ schematic_synthesizer.py
+│  │  ├─ pcb_router.py
+│  │  └─ gerber_exporter.py
+│  └─ pipeline/
+│     └─ cli.py
+└─ tests/
+   └─ test_footprint_generator.py
+```
+
+## Quickstart
+- Python 3.10+
+- KiCad 7/8 recommended for future steps (not required to try the footprint generator)
+
+Install:
+
+```bash
+pip install -e .
+```
+
+Generate a 0603 resistor footprint:
+
+```bash
+pcbai footprint --type smd_rc --name R_0603 --body-l 1.6 --body-w 0.8 --pad-l 0.9 --pad-w 0.8 --gap 0.8 --out build/
+```
+
+Generate a 14-pin SOIC footprint:
+
+```bash
+pcbai footprint --type soic --name SOIC-14_3.9x8.7mm_P1.27mm \
+  --pins 14 --pitch 1.27 --body-l 8.7 --body-w 3.9 --pad-l 1.5 --pad-w 0.6 --row-offset 2.3 --out build/
+```
+
+You will find `.kicad_mod` files in `build/` to drop into a KiCad library.
+
+## Vision + Datasheet extraction
+- Planned: PDF/image → text/structured extraction using OCR + LLM-Vision to infer package params when IPC tables are present.
+- Today: you can provide measured params directly to the generator.
+
+## Schematic/Netlist synthesis
+- Planned: SKiDL-based netlist generation from component set + reference circuits.
+
+## PCB routing and Gerbers
+- Planned: KiCad pcbnew and Freerouting integration; `kicad-cli` for Gerbers.
+- Adapters for Altium/Cadence will require respective licensed tool installations and API keys.
+
+## Configuration
+- All runtime config via environment variables or a YAML file, see `src/pcbai/core/config.py`.
+
+## Contributing
+- PRs welcome. Focus areas:
+  - Datasheet parsers and CV feature extractors
+  - More package generators (QFN/QFP/BGA)
+  - SKiDL schematic templates
+  - EDA tool adapters
+
+## License
+Dual-licensed: 
+- Non-commercial, open-source use granted under the Custom License in LICENSE.
+- Commercial/enterprise use requires prior written authorization from the author. Contact: set your email in LICENSE.

pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pcb-designer-ai-agent"
+version = "0.0.1"
+description = "Agentic pipeline from natural language to PCB (BOM → footprints → schematic → routing → Gerbers)"
+authors = [{ name = "PCB Designer AI Agent Contributors" }]
+readme = "README.md"
+requires-python = ">=3.10"
+license = { file = "LICENSE" }
+dependencies = [
+  "pydantic>=2.6",
+  "click>=8.1",
+  "requests>=2.31",
+  "python-dotenv>=1.0",
+]
+
+[project.optional-dependencies]
+llm = ["openai>=1.0", "tiktoken>=0.6"]
+vision = [
+  "pillow>=10.3",
+  "pytesseract>=0.3.10",
+  "pdfminer.six>=20221105",
+  "camelot-py[cv]>=0.11.0",
+  "opencv-python-headless>=4.8",
+  "pypdf>=4.2"
+]
+eda = [
+  "skidl>=0.1.0",
+]
+ki = [
+  # KiCad's pcbnew is provided by KiCad; no pip package. This is a placeholder group.
+]
+
+test = ["pytest>=8.2"]
+
+[project.scripts]
+pcbai = "pcbai.pipeline.cli:main"
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]

src/pcbai/__init__.py

@@ -0,0 +1,2 @@
+__all__ = ["__version__"]
+__version__ = "0.0.1"

src/pcbai/core/config.py

@@ -0,0 +1,27 @@
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from typing import Optional
+
+
+@dataclass
+class Settings:
+    # General
+    log_level: str = os.getenv("PCB_AI_LOG", "INFO")
+
+    # LLM
+    llm_provider: str = os.getenv("PCB_AI_LLM_PROVIDER", "openai")
+    openai_api_key: Optional[str] = os.getenv("OPENAI_API_KEY")
+    ollama_host: str = os.getenv("OLLAMA_HOST", "http://localhost:11434")
+
+    # Paths
+    workdir: str = os.getenv("PCB_AI_WORKDIR", os.path.abspath("build"))
+
+    # EDA tool backends
+    kicad_cli: str = os.getenv("KICAD_CLI", "kicad-cli")
+    altium_api_key: Optional[str] = os.getenv("ALTIUM_API_KEY")
+    cadence_api_key: Optional[str] = os.getenv("CADENCE_API_KEY")
+
+
+settings = Settings()

src/pcbai/core/logger.py

@@ -0,0 +1,19 @@
+import logging
+import sys
+
+
+def get_logger(name: str = "pcbai", level: int = logging.INFO) -> logging.Logger:
+    logger = logging.getLogger(name)
+    if logger.handlers:
+        return logger
+    logger.setLevel(level)
+
+    handler = logging.StreamHandler(sys.stdout)
+    fmt = logging.Formatter(
+        fmt="%(asctime)s | %(levelname)s | %(name)s | %(message)s",
+        datefmt="%H:%M:%S",
+    )
+    handler.setFormatter(fmt)
+    logger.addHandler(handler)
+    logger.propagate = False
+    return logger

src/pcbai/llm/provider.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import Dict, Any
+
+
+class LLMProvider(ABC):
+    @abstractmethod
+    def complete(self, prompt: str, **kwargs) -> str:
+        ...
+
+
+class DummyProvider(LLMProvider):
+    def complete(self, prompt: str, **kwargs) -> str:
+        return "TODO: implement real provider or configure via env"