Loading files
This file is pinned to the selected release. Download the original to open it in your design tool.
8fa3436b2This file is pinned to the selected release. Download the original to open it in your design tool.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>fragua — AI-native PCB design</title>
<meta name="description" content="A desktop PCB design tool that lets your AI agent do the work. Schematic, placement, routing, DRC and a fab-ready zip — from one prompt.">
<!-- Open Graph / Twitter cards. Cheap to add, makes shared links not look broken. -->
<meta property="og:title" content="fragua — AI-native PCB design">
<meta property="og:description" content="The agent designs the PCB. You watch and steer. Schematic → routing → fab-ready zip in one loop.">
<meta property="og:url" content="https://mentasystems.github.io/fragua/">
<meta property="og:type" content="website">
<meta name="twitter:card" content="summary">
<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Crect width='16' height='16' fill='%230e1116'/%3E%3Crect x='2' y='2' width='12' height='12' rx='2' fill='none' stroke='%23d6905b' stroke-width='1.5'/%3E%3Ccircle cx='5' cy='8' r='1' fill='%23d6905b'/%3E%3Ccircle cx='11' cy='8' r='1' fill='%23d6905b'/%3E%3Cline x1='5' y1='8' x2='11' y2='8' stroke='%23d6905b' stroke-width='0.7'/%3E%3C/svg%3E">
<link rel="stylesheet" href="style.css">
</head>
<body>
<header class="topbar">
<div class="brand">
<svg class="logo" viewBox="0 0 32 32" aria-hidden="true">
<rect x="3" y="3" width="26" height="26" rx="3" fill="none" stroke="#d6905b" stroke-width="2"/>
<circle cx="9" cy="16" r="2" fill="#d6905b"/>
<circle cx="23" cy="16" r="2" fill="#d6905b"/>
<line x1="9" y1="16" x2="23" y2="16" stroke="#d6905b" stroke-width="1.4"/>
<line x1="16" y1="9" x2="16" y2="23" stroke="#d6905b" stroke-width="1.4"/>
</svg>
<span>fragua</span>
</div>
<nav class="topbar-links">
<a href="#how" data-i18n="nav.how">how it works</a>
<a href="#install" data-i18n="nav.install">install</a>
<a href="#status" data-i18n="nav.status">status</a>
<a class="github-link" href="blog/">Blog</a>
<a class="github-link" href="https://github.com/mentasystems/fragua">GitHub →</a>
<!-- Language toggle. Auto-detects browser language on first visit
(es-* → Spanish, everything else → English) and persists the
explicit choice in localStorage. -->
<span class="lang-toggle" role="group" aria-label="language">
<button type="button" data-lang="en">EN</button>
<button type="button" data-lang="es">ES</button>
</span>
</nav>
</header>
<main>
<section class="hero">
<div class="hero-text">
<h1 data-i18n="hero.h1">Your AI agent designs the PCB.<br>You watch and steer.</h1>
<p class="lede" data-i18n="hero.lede">
Fragua is a desktop tool that exposes a small, deterministic API for AI agents.
The agent drives the schematic, the placement, the auto-router, the rule
checks, and ships a fab-ready zip in a single loop. The human watches,
redirects when needed, and clicks "order".
</p>
<div class="hero-cta">
<a class="btn primary" href="https://github.com/mentasystems/fragua" data-i18n="hero.cta1">Get the source</a>
<a class="btn ghost" href="#install" data-i18n="hero.cta2">Run it locally</a>
</div>
</div>
<div class="hero-image" aria-hidden="true">
<!-- Real screenshot of the fragua app on the door-controller test
project: GND auto-pour on both layers, 31 traces / 16 vias, 0
DRC errors. Same UI the agent and the human share. -->
<img src="screenshot.png" alt="Fragua desktop app showing a routed PCB with the activity log and library panes open">
</div>
</section>
<section class="bullets" id="how">
<h2 data-i18n="bullets.h2">What it does</h2>
<div class="bullet-grid">
<div class="bullet">
<h3 data-i18n="b1.h3">One small surface for the agent</h3>
<p data-i18n="b1.p">
A line-oriented script DSL on a stateless local HTTP API. The agent
sends multi-line scripts; each verb is one tool call. The full
reference is printed at startup and at <code>GET /</code> — no SDK,
no protocol negotiation, no hidden state.
</p>
</div>
<div class="bullet">
<h3 data-i18n="b2.h3">Real router, not a wrapper</h3>
<p data-i18n="b2.p">
Multi-layer Theta* / A* with rip-up-and-reroute, optional negotiated
congestion, fine-pitch escape-slot fanout, and an organic post-pass.
Experimental topological engine available. Per-net and rule-area
widths / clearances from <code>NetClass</code>. No FreeRouting, no
<code>kicad-cli</code>.
</p>
</div>
<div class="bullet">
<h3 data-i18n="b3.h3">Real placer too</h3>
<p data-i18n="b3.p">
Two-stage placer: electrostatic global placement, then simulated
annealing legalisation (HPWL + body gap + congestion + crossings).
Edge planning for connectors, elevated modules on headers. The agent
names which refs may move; everything else stays where the human put it.
</p>
</div>
<div class="bullet">
<h3 data-i18n="b4.h3">Validation at every step</h3>
<p data-i18n="b4.p">
ERC catches netlist bugs (multiple drivers, unpowered power rails,
missing decoupling caps). DRC catches geometry bugs (clearance,
annular ring, narrow trace). Manufacturing-DRC catches what your
chosen fab will refuse before you upload.
</p>
</div>
<div class="bullet">
<h3 data-i18n="b5.h3">Fab-ready zip in one verb</h3>
<p data-i18n="b5.p">
<code>pack fab=jlcpcb</code> runs the whole validation pipeline,
emits Gerbers + Excellon drills + provider-specific BOM and CPL,
bundles them with a README, and drops a single
<code><project>-jlcpcb.zip</code> ready to upload. JLCPCB,
PCBWay and a generic format are built in; new houses are one match
arm away.
</p>
</div>
<div class="bullet">
<h3 data-i18n="b6.h3">Human stays in the loop</h3>
<p data-i18n="b6.p">
The desktop app shows the live state — every footprint placement,
every routed trace, every DRC violation. Click a component, drag
it, watch the agent re-plan. Nobody is locked out by either side.
</p>
</div>
</div>
</section>
<section class="recipe" id="recipe">
<h2 data-i18n="recipe.h2">End-to-end, in 25 lines</h2>
<p class="recipe-lead" data-i18n="recipe.lead">
What the agent might send to <code>POST /script</code>. Every line is
one verb; each verb commits to the project state and emits an event the
UI repaints from. The full pipeline — ERC, placement, routing, fab pack —
happens server-side in milliseconds-to-seconds.
</p>
<pre class="snippet"><span class="c"># Board, with rounded corners.</span>
outline 80 30 radius=2
<span class="c"># Net classes for the rails — GND on both layers as a pour.</span>
class ground pour=both
class power width=0.4
<span class="c"># Schematic (subset).</span>
sym U1 ic key=esp32_s3_zero
pin 1 L 3V3 role=power_in
pin 2 L GND role=power_in
pin 12 L SCL role=bidir
pin 11 L SDA role=bidir
sym C1 capacitor key=c_0603 value=100nF lcsc=C14663
sym R1 resistor key=r_0603 value=4.7k lcsc=C25814
sym R2 resistor key=r_0603 value=4.7k lcsc=C25814
net GND U1.GND C1.2 class=ground
net +3V3 U1.3V3 C1.1 R1.1 R2.1 class=power
net SDA U1.SDA R1.2
net SCL U1.SCL R2.2
<span class="c"># Pre-flight schematic check.</span>
erc
<span class="c"># Footprints + initial placement, then SA on the loose parts.</span>
palette U1 esp32_s3_zero
palette C1 c_0603
palette R1 r_0603
palette R2 r_0603
place U1 20 15
auto-place C1 R1 R2 seed=42
<span class="c"># Route, then ship the zip.</span>
route
pack fab=jlcpcb out=~/Downloads</pre>
</section>
<section class="install" id="install">
<h2 data-i18n="install.h2">Install & run</h2>
<p data-i18n="install.p1">Fragua is a single Go binary: local HTTP API and a browser UI. Pre-built binaries are on GitHub Releases; or build from source:</p>
<pre class="snippet"><span class="c"># One-liner install (macOS arm64/x64, Linux x64).</span>
curl -fsSL https://raw.githubusercontent.com/mentasystems/fragua/master/scripts/install.sh | sh
<span class="c"># From source:</span>
git clone https://github.com/mentasystems/fragua.git
cd fragua
go build -o fragua ./cmd/fragua
<span class="c"># Launch (the `run` subcommand starts the API + UI).</span>
./fragua run
<span class="c"># …or open an existing project file (autosave bound to it).</span>
./fragua run /path/to/board.fragua
<span class="c"># Bare `fragua` prints usage + the full script reference and exits.</span>
./fragua</pre>
<p data-i18n="install.p2">
The browser opens, and a stateless local HTTP API starts on
<code>127.0.0.1:7878</code> (override with <code>FRAGUA_API_ADDR</code>).
Point any agent that can make HTTP calls at it:
</p>
<pre class="snippet"><span class="c"># Discover the full action surface (also GET /help).</span>
curl -s http://127.0.0.1:7878/
<span class="c"># Liveness + headless board PNG.</span>
curl -s http://127.0.0.1:7878/health
curl -s 'http://127.0.0.1:7878/screenshot?view=board&width=1600' -o board.png
<span class="c"># Run a script.</span>
curl -s http://127.0.0.1:7878/script \
-H 'content-type: application/json' \
-d '{"script":"outline 80 30 radius=2\nstatus"}'</pre>
<p data-i18n="install.p3">Replies are <code>text/plain</code>: per-line outcomes, plus an unsaved-session warning if the project isn't bound to a file yet.</p>
</section>
<section class="status" id="status">
<h2 data-i18n="status.h2">Status</h2>
<p class="status-lead" data-i18n="status.lead">
<strong>v1.1.x</strong>. Every bullet below works in the current
<a href="https://github.com/mentasystems/fragua">master</a>; the
"what's next" list is what the maintainers are most likely to
work on, not a commitment.
</p>
<div class="status-grid">
<div>
<h3 data-i18n="status.today">Today</h3>
<ul>
<li data-i18n="today.1">Schematic with symbols, pins (electrical roles), nets, net classes, multi-sheet ports.</li>
<li data-i18n="today.2">Library of footprints with photos, datasheets, LCSC IDs, MPNs, edge-mount and elevated bodies.</li>
<li data-i18n="today.3">Two-stage auto-placer (ePlace global + SA legalisation, edge-plan, decoupling ring, compact).</li>
<li data-i18n="today.4">Auto-router (RR&R + optional negotiation + fine-pitch escape fanout + organic pass; experimental topo engine).</li>
<li data-i18n="today.5">ERC (incl. decoupling / I²C heuristics), DRC, manufacturing-DRC; rule areas and fab-rules.</li>
<li data-i18n="today.6">Auto-pour from net classes; multi-layer stackup; polygonal outlines, milled cutouts, NPTH holes.</li>
<li data-i18n="today.7">One-shot <code>pack</code> (JLCPCB / PCBWay / generic zip) + ODB++ <code>.tgz</code> from the UI.</li>
<li data-i18n="today.8">Headless <code>GET /screenshot</code> and <code>screenshot</code> script verb for agent verification.</li>
<li data-i18n="today.9">Live SVG canvas with pan/zoom and click-to-inspect.</li>
</ul>
</div>
<div>
<h3 data-i18n="status.next">What's next</h3>
<ul>
<li data-i18n="next.1">An embedded LCSC catalogue subset so the agent doesn't have to look up part numbers by hand.</li>
<li data-i18n="next.2">Richer heuristic ERC: "USB without ESD", "MCU without crystal load caps".</li>
<li data-i18n="next.3">ODB++ export as a first-class script verb (UI export already works).</li>
<li data-i18n="next.4">Real-time cost estimation against the chosen fab's pricing tier.</li>
<li data-i18n="next.5">More fab providers (OSHPark, Aisler, Eurocircuits).</li>
<li data-i18n="next.6">Frontend: click a net to highlight it, jump-to from the DRC violation list.</li>
</ul>
</div>
</div>
</section>
<section class="oss">
<h2 data-i18n="oss.h2">Open source</h2>
<p data-i18n="oss.p1">
MIT licensed. See <a href="https://github.com/mentasystems/fragua/blob/master/CONTRIBUTING.md">CONTRIBUTING.md</a> for what's in scope. Issues
and PRs welcome — especially adding fab providers, library
parts, and bug fixes from real-world designs.
</p>
<p class="quiet" data-i18n="oss.p2">
Built in Go. No <code>kicad-cli</code>, no
FreeRouting wrapper, no shell-out. Every file format read or written
is implemented in this repo.
</p>
</section>
</main>
<footer>
<div>
<a href="https://github.com/mentasystems/fragua">github.com/mentasystems/fragua</a>
<span class="dot">·</span>
<span data-i18n="footer.license">MIT license</span>
<span class="dot">·</span>
<a href="https://github.com/mentasystems/fragua/blob/master/VISION.md" data-i18n="footer.vision">vision</a>
<span class="dot">·</span>
<a href="https://github.com/mentasystems/fragua/blob/master/ARCHITECTURE.md" data-i18n="footer.architecture">architecture</a>
</div>
</footer>
<script>
// Client-side i18n for the static landing. Prose only — code snippets stay
// in English (they are code). English is the source/default; Spanish is
// served when the browser prefers it. An explicit toggle overrides the
// detection and is remembered in localStorage.
(function () {
"use strict";
// Spanish overrides, keyed by the same data-i18n names used in the markup.
// Any key absent here falls back to the English already in the DOM.
var ES = {
"nav.how": "cómo funciona",
"nav.install": "instalación",
"nav.status": "estado",
"hero.h1": "Tu agente de IA diseña la PCB.<br>Tú observas y diriges.",
"hero.lede": "Fragua es una herramienta de escritorio que expone una API pequeña y determinista para agentes de IA. El agente conduce el esquemático, el emplazamiento, el auto-router, las comprobaciones de reglas y entrega un zip listo para fabricar en un solo bucle. El humano observa, redirige cuando hace falta y hace clic en «pedir».",
"hero.cta1": "Consigue el código",
"hero.cta2": "Ejecútalo en local",
"bullets.h2": "Qué hace",
"b1.h3": "Una superficie pequeña para el agente",
"b1.p": "Un DSL de scripts orientado a líneas sobre una API HTTP local sin estado. El agente envía scripts multilínea; cada verbo es una llamada de herramienta. La referencia completa se imprime al arrancar y en <code>GET /</code> — sin SDK, sin negociación de protocolo, sin estado oculto.",
"b2.h3": "Un router de verdad, no un envoltorio",
"b2.p": "Theta* / A* multicapa con rip-up-and-reroute, congestión negociada opcional, fanout de escape para fine-pitch y un post-paso orgánico. Motor topológico experimental disponible. Anchos y separaciones por red y por rule-area desde <code>NetClass</code>. Sin FreeRouting, sin <code>kicad-cli</code>.",
"b3.h3": "Un placer de verdad también",
"b3.p": "Placer en dos etapas: emplazamiento global electrostático y legalización por recocido simulado (HPWL + separación de cuerpos + congestión + cruces). Planificación de borde para conectores, módulos elevated sobre headers. El agente nombra qué refs pueden moverse; el resto se queda donde lo puso el humano.",
"b4.h3": "Validación en cada paso",
"b4.p": "El ERC detecta bugs de netlist (varios drivers, raíles de alimentación sin alimentar, condensadores de desacoplo que faltan). El DRC detecta bugs de geometría (separación, anillo anular, pista estrecha). El DRC de fabricación detecta lo que tu fábrica elegida rechazará antes de que lo subas.",
"b5.h3": "Zip listo para fabricar en un verbo",
"b5.p": "<code>pack fab=jlcpcb</code> ejecuta toda la pipeline de validación, emite Gerbers + taladros Excellon + BOM y CPL específicos del proveedor, los empaqueta con un README y suelta un único <code><proyecto>-jlcpcb.zip</code> listo para subir. JLCPCB, PCBWay y un formato genérico vienen integrados; añadir nuevas fábricas es un match arm más.",
"b6.h3": "El humano sigue en el bucle",
"b6.p": "La app de escritorio muestra el estado en vivo — cada emplazamiento de footprint, cada pista enrutada, cada violación de DRC. Haz clic en un componente, arrástralo y mira cómo el agente re-planifica. Ninguna de las dos partes queda bloqueada.",
"recipe.h2": "De principio a fin, en 25 líneas",
"recipe.lead": "Lo que el agente podría enviar a <code>POST /script</code>. Cada línea es un verbo; cada verbo confirma en el estado del proyecto y emite un evento desde el que la UI se repinta. La pipeline completa — ERC, emplazamiento, enrutado, empaquetado de fabricación — ocurre en el servidor en milisegundos-a-segundos.",
"install.h2": "Instalación y ejecución",
"install.p1": "Fragua es un único binario Go: API HTTP local y UI en el navegador. Hay binarios precompilados en GitHub Releases; o compílalo desde el código:",
"install.p2": "Se abre el navegador y arranca una API HTTP local sin estado en <code>127.0.0.1:7878</code> (se puede cambiar con <code>FRAGUA_API_ADDR</code>). Apunta hacia ella cualquier agente que pueda hacer llamadas HTTP:",
"install.p3": "Las respuestas son <code>text/plain</code>: resultados línea a línea, más un aviso de sesión sin guardar si el proyecto aún no está ligado a un fichero.",
"status.h2": "Estado",
"status.lead": "<strong>v1.1.x</strong>. Cada punto de abajo funciona en la <a href=\"https://github.com/mentasystems/fragua\">master</a> actual; la lista de «qué viene» es en lo que es más probable que trabajen los mantenedores, no un compromiso.",
"status.today": "Hoy",
"today.1": "Esquemático con símbolos, pines (roles eléctricos), redes, clases de red y puertos multi-hoja.",
"today.2": "Librería de footprints con fotos, datasheets, IDs de LCSC, MPNs, edge-mount y cuerpos elevated.",
"today.3": "Auto-placer en dos etapas (ePlace global + legalización SA, edge-plan, anillo de desacoplo, compact).",
"today.4": "Auto-router (RR&R + negociación opcional + fanout de escape fine-pitch + paso orgánico; motor topo experimental).",
"today.5": "ERC (incl. heurísticas de desacoplo / I²C), DRC, DRC de fabricación; rule areas y fab-rules.",
"today.6": "Auto-pour desde clases de red; stackup multicapa; contornos poligonales, cutouts fresados, agujeros NPTH.",
"today.7": "Verbo <code>pack</code> (zip JLCPCB / PCBWay / genérico) + ODB++ <code>.tgz</code> desde la UI.",
"today.8": "<code>GET /screenshot</code> y verbo <code>screenshot</code> headless para verificación del agente.",
"today.9": "Lienzo SVG en vivo con pan/zoom y clic-para-inspeccionar.",
"status.next": "Qué viene",
"next.1": "Un subconjunto embebido del catálogo LCSC para que el agente no tenga que buscar part numbers a mano.",
"next.2": "ERC heurístico más rico: «USB sin ESD», «MCU sin condensadores de carga de cristal».",
"next.3": "Export ODB++ como verbo de script de primera clase (la UI ya exporta).",
"next.4": "Estimación de coste en tiempo real contra el tramo de precios de la fábrica elegida.",
"next.5": "Más proveedores de fabricación (OSHPark, Aisler, Eurocircuits).",
"next.6": "Frontend: clic en una red para resaltarla, salto desde la lista de violaciones de DRC.",
"oss.h2": "Código abierto",
"oss.p1": "Con licencia MIT. Consulta <a href=\"https://github.com/mentasystems/fragua/blob/master/CONTRIBUTING.md\">CONTRIBUTING.md</a> para ver qué entra en el alcance. Issues y PRs bienvenidos — especialmente añadir proveedores de fabricación, piezas de librería y arreglos de bugs de diseños reales.",
"oss.p2": "Construido en Go. Sin <code>kicad-cli</code>, sin envoltorio de FreeRouting, sin shell-out. Cada formato de fichero leído o escrito está implementado en este repo.",
"footer.license": "licencia MIT",
"footer.vision": "visión",
"footer.architecture": "arquitectura"
};
var TITLE = { en: "fragua — AI-native PCB design", es: "fragua — diseño de PCB nativo de IA" };
// Snapshot the shipped English so toggling back is lossless.
var EN = {};
var nodes = document.querySelectorAll("[data-i18n]");
nodes.forEach(function (el) { EN[el.getAttribute("data-i18n")] = el.innerHTML; });
function apply(lang) {
var dict = lang === "es" ? ES : null;
nodes.forEach(function (el) {
var key = el.getAttribute("data-i18n");
var val = dict && dict[key] != null ? dict[key] : EN[key];
if (val != null) el.innerHTML = val;
});
document.documentElement.lang = lang;
document.title = TITLE[lang] || TITLE.en;
document.querySelectorAll(".lang-toggle button").forEach(function (b) {
b.setAttribute("aria-pressed", String(b.getAttribute("data-lang") === lang));
});
}
function detect() {
try {
var saved = localStorage.getItem("fragua_lang");
if (saved === "en" || saved === "es") return saved;
} catch (e) { /* private mode */ }
var nav = (navigator.language || (navigator.languages && navigator.languages[0]) || "en").toLowerCase();
return nav.indexOf("es") === 0 ? "es" : "en";
}
document.querySelectorAll(".lang-toggle button").forEach(function (b) {
b.addEventListener("click", function () {
var lang = b.getAttribute("data-lang");
try { localStorage.setItem("fragua_lang", lang); } catch (e) { /* ignore */ }
apply(lang);
});
});
apply(detect());
})();
</script>
</body>
</html>