silicai 0.1.0

Structured electronic component descriptions for AI-assisted circuit design

SilicAI

Copyright 2026 mageo services Ltd — Licensed under the PolyForm Noncommercial License 1.0.0. Commercial use requires a separate license.

Structured electronic component descriptions for AI-assisted circuit design.

Concept

Electronic component information lives in PDF datasheets — unstructured, hard for AI to consume. SilicAI defines a YAML schema that captures everything needed to design circuits correctly:

• Pin directions and functions (primary + all alternate functions)
• Power rails with per-pin and bulk decoupling requirements
• Required external components (filters, pull-ups, decoupling)
• Standard net definitions and electrical characteristics

The goal is to give AI tools the structured context they need to generate correct, production-ready schematics.

Structure

src/silicai/
  validate.py        Schema validation CLI
  generate.py        KiCad schematic generator
  mcp_server.py      MCP server for Claude Code integration
  schema/            JSON Schema definitions
    component.schema.json
    circuit.schema.json
    project.schema.json
    defs/            Shared schema definitions
  components/        Built-in component library (silicai-components submodule)
nets/                Standard net definitions (GND, VCC_3V3, ...)
tests/               Test suite

The component library is bundled as a git submodule (mageoch/silicai-components) and loaded automatically — no extra configuration needed. Additional component libraries can be declared in a project's pyproject.toml:

[tool.silicai]
component_libraries = [
    { path = "path/to/extra-components" },
]

Usage

# Clone with submodules
git clone --recurse-submodules [e-mail]:mageoch/silicai.git

uv sync

# Validate a component or circuit file
silicai-validate path/to/component.yaml

# Generate a KiCad schematic from a circuit definition
silicai-generate path/to/circuit.yaml --output kicad/

# Run the MCP server
silicai-mcp --project-dir .

MCP Server

SilicAI exposes a Model Context Protocol server that lets Claude Code read component definitions and generate schematics. Add to your project's .mcp.json:

{
  "mcpServers": {
    "SilicAI": {
      "type": "stdio",
      "command": ".venv/bin/silicai-mcp",
      "args": ["--project-dir", "."]
    }
  }
}

Documentation

Schema reference: mageoch.github.io/silicai

Status

v0.1.0 — public beta. Core schema, validation, KiCad generation, and MCP server are functional. Schema and component format may evolve before a stable 1.0 release.