evolus /pencil
The Pencil Project's unique mission is to build a free and opensource tool for making diagrams and GUI prototyping that everyone can use.
★ 9,915⑂ 796👁 257⑃ 141● 678▤ 12
+1
Daily
9,915
stars
796
forks
257
watchers
141
prs
678
issues
12
releases
README
Pencil
An open-source GUI prototyping and wireframing application for macOS, Windows, and Linux.
Website •
Downloads •
Stencils & Templates
!Pencil V4 Interface and Canvas
---
Overview
Pencil is a free, open-source, desktop-native wireframing and prototyping tool for macOS, Windows, and Linux (pencil.evolus.vn). Built for developers, UX designers, and product teams, it provides an intuitive vector canvas environment for constructing mockups, system diagrams, and user flows using standard vector stencil libraries.
Key Capabilities & Architecture in V4.0
Pencil V4.0 introduces native support for the Model Context Protocol (MCP). This enables any AI assistant or LLM client that supports standard MCP (including Claude Desktop, Cursor, Antigravity, VS Code, or custom agents) to inspect, create, and modify wireframes directly on your canvas using everyday language. Pencil runs a local server right inside the app at http://127.0.0.1:1919/mcp, with no extra background services or cloud setups required.
- Natural Language to Vector Canvas: AI assistants convert prompts (e.g. "Create a 3-tier pricing table using shadcn/ui") directly into canvas operations via MCP tools (insert_shapes, shift_layout). Components are positioned with calculated bounds, not flat image overlays.
- True Vector Primitives: Generates native, fully editable vector stencils and shapes instead of raster bitmaps or static mockups. Every AI-created element can be resized, restyled, or reorganized on the canvas at any time.
- 100% Local-First & Private: All document data (.ep, .epz) and MCP requests stay strictly on your local machine over loopback (127.0.0.1). No cloud syncing, third-party analytics, or telemetry.
- Autonomous Vision QA Loop: Exposes a visual snapshot mechanism (render_preview), allowing LLMs to inspect the rendered canvas, verify spacing/alignment/contrast, and perform iterative layout corrections autonomously.
- Dynamic Layout & Spacing: Built-in container structures automatically manage padding, element distribution, and offsets, eliminating manual pixel math when appending or reordering components.
- Stencil & Icon Introspection: Connected assistants can query installed stencil libraries (shadcn/ui, Bootstrap, Material Design, iOS, Flowcharts) and search icon catalogs (Tabler, Lucide, FontAwesome) on demand.
---
Quick Start (Prebuilt Binaries)
For end users who do not require building from source:
1. Download: Obtain the latest installer or package for your operating system from the Pencil Downloads Page or GitHub Releases.
2. Launch: Open Pencil. You can immediately begin creating wireframes and diagrams using the built-in stencil collections.
3. Connect AI (Optional): To enable AI-assisted prototyping, follow the setup in Connecting AI Clients below.
---
Connecting AI Clients
Pencil provides built-in configuration snippets for popular tools (Claude Desktop, Cursor, Antigravity, aTop issues
#308Unable to open my pencil file59 comments · 2017-04-27#350Pencil v3 not working 32 comments · 2017-06-26#157Pencil freezes on save prompt22 comments · 2016-09-14#605pencil doesn't start on openSuSE17 comments · 2020-02-07#590Search for shapes doesn't works16 comments · 2019-11-21#427Dark UI theme15 comments · 2017-10-09#76Windows 10 is detecting Malware in the code base15 comments · 2016-08-02#580Can't get Links to work in Chrome or Firefox when exported as single web page14 comments · 2019-10-22
Latest release
4.0.0 v4.0.0 2026-10-24Pencil 4.0.0 Pencil 4.0 transforms Pencil into an AI-ready visual design studio! You can now pair your favorite AI coding assistants directly with Pencil to build, refine, and iterate on vector wireframes in real time. --- Key Highlights - Design Wireframes with AI: Connect assistants like Claude Desktop, Cursor, Antigravity, and VS Code to design, arrange, and edit wireframes on your canvas using natural language. - Instant, Zero-Lag Canvas Updates: AI operations happen in memory in real time, with no waiting on disk polling, reloads, or file saving. - Smart Auto-Layout Contain