SynthPilot

KO | EN

gitlite — search

#python #hacktoberfest #typescript #llm #machine-learning #nodejs #macos #java #windows #vue #pytorch #ios #openai #open-source

(★ 54)

Talk to your AI. Watch it drive Vivado. — an MCP server for AI-driven FPGA development on Xilinx Vivado.

SynthPilot Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SynthPilot

**Talk to your AI. Watch it drive Vivado.**

[![PyPI](https://img.shields.io/pypi/v/synthpilot)](https://pypi.org/project/synthpilot/)
[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://pypi.org/project/synthpilot/)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux-lightgrey)](https://pypi.org/project/synthpilot/)
[![License](https://img.shields.io/badge/license-proprietary-orange)](https://raw.githubusercontent.com/LNC0831/SynthPilot/main/)
[![Stars](https://img.shields.io/github/stars/LNC0831/SynthPilot?style=social)](https://github.com/LNC0831/SynthPilot)

[Website](https://synthpilot.dev) · [Docs](https://synthpilot.dev/docs.html) · [oh-my-fpga skills](https://github.com/LNC0831/oh-my-fpga) · [PyPI](https://pypi.org/project/synthpilot/) · [Changelog](CHANGELOG.md)

</div>

> **English** | [简体中文](#简体中文)

SynthPilot is an [MCP](https://modelcontextprotocol.io) server that lets your AI assistant
(Claude, Cursor, Cline, …) **control Xilinx Vivado** for FPGA development — create projects,
write and lint RTL, run synthesis/implementation, close timing, configure IP & Block
Designs, run simulations, and program hardware — all by **describing what you want**, in
plain language.

It runs **locally**: your RTL never leaves your machine. **500+ tools** cover the whole FPGA
flow, and a free methodology layer ([oh-my-fpga](https://github.com/LNC0831/oh-my-fpga))
turns them into one-sentence outcomes.

> *Used by engineers from **AMD**, **Tsinghua / Fudan / SJTU** and the **Chinese Academy of
> Sciences (CAS)**, FPGA vendor **Fudan Microelectronics (复旦微)**, and lidar leaders
> **Hesai (禾赛)** and **Benewake (北醒)**.*

## How it works

```
 AI editor (Claude / Cursor / Cline / …)
        │   MCP (stdio)
        ▼
   SynthPilot   ──TCP:9999──▶   Vivado (Tcl server)
```

The AI calls SynthPilot tools; SynthPilot drives Vivado over a local socket and returns
structured results (timing metrics, utilization, error summaries, waveforms …) back to the AI.

## See it in action

> You: *"Create an Artix-7 project, add this counter, run synthesis, and show me the timing."*
>
> The AI: `create_project` → `add_source_file` → `run_synthesis` → `report_timing_summary`
> → reports WNS/TNS and flags any failing paths — no Tcl, no wizard clicking.

## Quick start

```bash
uv tool install synthpilot      # requires uv — https://docs.astral.sh/uv/
synthpilot setup                # guided, one-command onboarding
```

`synthpilot setup` does the rest for you: it detects Vivado and installs the Tcl server,
activates your license, and **registers SynthPilot in your AI editor — no hand-editing JSON**
(Claude Code, Claude Desktop, Cursor, Codex), then runs an end-to-end health check.
Something off later? `synthpilot doctor` diagnoses it and `synthpilot doctor --fix`
self-heals.

<details>
<summary>Prefer to wire the MCP client up by hand?</summary>

```jsonc
{ "mcpServers": { "synthpilot": { "command": "synthpilot" } } }
```

Works with Claude Desktop / Claude Code, Cursor, Cline, Codex, and other MCP clients.
</details>

## Skills & methodology — [oh-my-fpga](https://github.com/LNC0831/oh-my-fpga)

500 tools give your AI *capability* — not *strategy*.
**[oh-my-fpga](https://github.com/LNC0831/oh-my-fpga)** is a **free, open** companion that
adds the methodology layer: named, expert workflows like *"close timing"*, *"audit CDC"*,
*"bring up a Zynq SoC"*. You describe the outcome; the AI runs the right tools in the right
order, with the right safety rails (verify before claiming, never fake-pass a real violation).

- **Claude Code** — `/plugin marketplace add LNC0831/oh-my-fpga` then `/plugin install oh-my-fpga`
- **Cursor · Codex · Claude Desktop** — the same 13 workflows ship as **MCP prompts** built
  into SynthPilot (1.3.0+); pick them from your client's `/` menu.

→ **[github.com/LNC0831/oh-my-fpga](https://github.com/LNC0831/oh-my-fpga)**

## Editions

| | Free | Pro | Max |
|---|---|---|---|
| Tools | **40** core | **~475** | **all 500+** |
| Project / synth / impl / basic reports | ✅ | ✅ | ✅ |
| IP config · Block Design · Simulation · Linter · async runs | — | ✅ | ✅ |
| Devices | 1 | 2 | 3 |

The methodology layer ([oh-my-fpga](https://github.com/LNC0831/oh-my-fpga)) is **free for
everyone**, on every edition. Pricing, a **¥1 / 7-day trial**, and team / offline / academic
editions are on **[synthpilot.dev](https://synthpilot.dev)**.

## Requirements

- Xilinx Vivado 2018.1+ (Windows or Linux)
- An MCP-capable AI client
- [uv](https://docs.astral.sh/uv/) (Python 3.10+ is fetched automatically)

## Links

- 🌐 Website & pricing — https://synthpilot.dev
- 🧠 oh-my-fpga skills — https://github.com/LNC0831/oh-my-fpga
- 📦 PyPI — https://pypi.org/project/synthpilot/
- 📖 Docs — https://synthpilot.dev/docs.html
- 🗒️ [Changelog](CHANGELOG.md)

## License

SynthPilot is a **proprietary** commercial product. This repository hosts its public
documentation and marketing materials only — the software itself is distributed via PyPI.
The RTL you process stays on your machine; SynthPilot does not upload your design sources.
(The companion [oh-my-fpga](https://github.com/LNC0831/oh-my-fpga) skill pack is separate and
MIT-licensed.)

---

## 简体中文

**对你的 AI 说一句话,它替你操作 Vivado。**

SynthPilot 是一个 [MCP](https://modelcontextprotocol.io) 服务器,让你的 AI 助手(Claude、
Cursor、Cline…)用**自然语言**控制 Xilinx Vivado 做 FPGA 开发——建项目、写/查 RTL、
跑综合与实现、收敛时序、配置 IP 与 Block Design、跑仿真、烧录硬件。

**全程本地运行,你的 RTL 不出本机。500+ 工具**覆盖完整 FPGA 流程,再加一层免费的方法论
([oh-my-fpga](https://github.com/LNC0831/oh-my-fpga)),把它们变成一句话的结果。

> *已被 **AMD**、**清华 / 复旦 / 上海交大** 与 **中科院(CAS)** 的工程师,国产 FPGA 厂商
> **复旦微**,以及激光雷达企业 **禾赛、北醒** 使用。*

### 工作原理

```
 AI 编辑器 (Claude / Cursor / Cline / …)
        │   MCP (stdio)
        ▼
   SynthPilot   ──TCP:9999──▶   Vivado (Tcl 服务器)
```

AI 调用 SynthPilot 的工具,SynthPilot 通过本地 socket 驱动 Vivado,并把结构化结果
(时序指标、资源利用、错误摘要、波形…)返回给 AI。

### 一个例子

> 你:*"建一个 Artix-7 工程,加入这个计数器,跑综合,把时序给我看看。"*
>
> AI:`create_project` → `add_source_file` → `run_synthesis` → `report_timing_summary`
> → 报告 WNS/TNS 并标出违例路径——不写 Tcl,不点向导。

### 快速开始

```bash
uv tool install synthpilot      # 需要 uv —— https://docs.astral.sh/uv/
synthpilot setup                # 一条命令,引导式上手
```

`synthpilot setup` 替你把剩下的事做完:检测 Vivado 并安装 Tcl 服务器、激活授权,并
**把 SynthPilot 注册进你的 AI 编辑器——免手改 JSON**(Claude Code、Claude Desktop、
Cursor、Codex),最后跑一遍端到端健康检查。后面出问题?`synthpilot doctor` 自检、
`synthpilot doctor --fix` 自愈。

<details>
<summary>想手动配置 MCP 客户端?</summary>

```jsonc
{ "mcpServers": { "synthpilot": { "command": "synthpilot" } } }
```

支持 Claude Desktop / Claude Code、Cursor、Cline、Codex 等 MCP 客户端。
</details>

### 技能与方法论 —— [oh-my-fpga](https://github.com/LNC0831/oh-my-fpga)

500 个工具给 AI 的是*能力*,不是*策略*。
**[oh-my-fpga](https://github.com/LNC0831/oh-my-fpga)** 是一个**免费开源**的配套,补上方法论
这一层:一组命名的专家工作流,比如 *"收敛时序"*、*"审查 CDC"*、*"搭一个 Zynq SoC"*。你说
出想要的结果,AI 就按正确顺序调用正确的工具,带着正确的安全护栏(先验证再下结论,绝不为了
让数字变绿而假装通过)。

- **Claude Code** —— `/plugin marketplace add LNC0831/oh-my-fpga` 然后 `/plugin install oh-my-fpga`
- **Cursor · Codex · Claude Desktop** —— 同样这 13 个工作流作为 **MCP prompts** 内置在
  SynthPilot(1.3.0+),在客户端的 `/` 菜单里选用。

→ **[github.com/LNC0831/oh-my-fpga](https://github.com/LNC0831/oh-my-fpga)**

### 档位

| | 免费版 | Pro | Max |
|---|---|---|---|
| 工具数 | **40** 基础 | **约 475** | **全部 500+** |
| 工程 / 综合 / 实现 / 基础报告 | ✅ | ✅ | ✅ |
| IP 配置 · Block Design · 仿真 · Linter · 异步执行 | — | ✅ | ✅ |
| 设备数 | 1 | 2 | 3 |

方法论层([oh-my-fpga](https://github.com/LNC0831/oh-my-fpga))对**所有人、所有档位永久免费**。
定价、**¥1 / 7 天试用**,以及团队 / 离线 / 高校版,见 **[synthpilot.dev](https://synthpilot.dev)**。

### 环境要求

- Xilinx Vivado 2018.1+(Windows 或 Linux)
- 一个支持 MCP 的 AI 客户端
- [uv](https://docs.astral.sh/uv/)(Python 3.10+ 会自动获取)

### 链接

- 🌐 官网与定价 —— https://synthpilot.dev
- 🧠 oh-my-fpga 技能包 —— https://github.com/LNC0831/oh-my-fpga
- 📦 PyPI —— https://pypi.org/project/synthpilot/
- 📖 文档 —— https://synthpilot.dev/docs.html
- 🗒️ [更新日志](CHANGELOG.md)

### 授权

SynthPilot 是**专有**商业产品。本仓库仅托管其公开文档与宣传材料,软件本体经 PyPI 分发。
你处理的 RTL 始终留在本机,SynthPilot 不上传你的设计源码。(配套的
[oh-my-fpga](https://github.com/LNC0831/oh-my-fpga) 技能包是独立的 MIT 开源项目。)

SynthPilot

SynthPilot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

SynthPilot

SynthPilot Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README