Nano Tech Diagrams

A tool for creating and editing tech diagrams using Fal AI's Nano Banana 2 model. Available as a desktop GUI (Python/PyQt6), CLI, MCP server (Python), and npm package with MCP server (TypeScript).

Before & After

Chalkboard Style

Blueprint Style

Pixel Art Style

Neon Sign Style

Corporate Clean Style

More samples available in the Sample-Whiteboards companion repo.

What It Does

• Text-to-image: Generate tech diagrams from text descriptions
• Image-to-image: Transform existing images into styled diagrams
• Whiteboard cleanup: Clean up whiteboard photos into polished graphics
• 28+ style presets across 6 categories
• 20 diagram type presets (network, flowchart, mind map, K8s cluster, etc.)

MCP Server (npm)

Install via Claude Code

claude mcp add nano-tech-diagrams -e FAL_KEY=your-fal-api-key -- npx -y nano-tech-diagrams

Manual JSON config

Add to your Claude Code MCP settings (~/.claude/settings.json or project .mcp.json):

{
  "mcpServers": {
    "nano-tech-diagrams": {
      "command": "npx",
      "args": ["-y", "nano-tech-diagrams"],
      "env": {
        "FAL_KEY": "your-fal-api-key"
      }
    }
  }
}

MCP Tools

| Tool | Description | |------|-------------| | list_styles | List all 28+ visual style presets | | list_diagram_types | List all diagram type presets | | whiteboard_cleanup | Clean up a whiteboard photo into a polished diagram | | image_to_image | Transform an image into a styled tech diagram | | text_to_image | Generate a diagram from a text description |

Defaults

• Model: Nano Banana 2 (baked in)
• Resolution: 1K
• Reasoning: Minimal
• Output format: PNG
• Aspect ratio: auto (configurable per call)

Desktop GUI (Python)

Install from source

git clone https://github.com/danielrosehill/Nano-Whiteboard-Doctor.git
cd Nano-Whiteboard-Doctor
uv sync
uv run nano-tech-diagrams

Install from .deb

Download the .deb from Releases:

sudo dpkg -i nano-tech-diagrams_0.3.0_all.deb
nano-tech-diagrams

GUI Usage

1. Click Add Images or drag and drop whiteboard photos
2. (Optional) Double-click an image to add a word dictionary for tricky terms
3. Choose a Style Preset from the dropdown (or write a custom prompt)
4. (Optional) Adjust output format, resolution, and aspect ratio
5. Click Process
6. Click any result thumbnail to view it full-size
7. From the enlarged view, click Send Back for Touchups to re-process

CLI

# Text-to-image
nano-tech-diagrams --text "Kubernetes cluster with 3 worker nodes" --style blueprint --diagram-type kubernetes_cluster

# Image-to-image
nano-tech-diagrams photo.jpg --style corporate_clean

# Whiteboard cleanup
nano-tech-diagrams whiteboard.jpg --whiteboard --style clean_polished

# List presets
nano-tech-diagrams --list-styles
nano-tech-diagrams --list-diagram-types

Style Presets

Professional

| Preset | Description | |--------|-------------| | Clean & Polished | Clear labels and icons on a white background -- the default | | Corporate Clean | Minimalist corporate slide-ready diagram | | Hand-Drawn Polished | Refined sketch -- designer's notebook feel | | Minimalist Mono | Black and white, Bauhaus-inspired minimalism | | Ultra Sleek | Thin lines, Swiss design aesthetic | | Blog Hero | Gradient background, 16:9 blog featured image |

Creative

| Preset | Description | |--------|-------------| | Colorful Infographic | Bold, vibrant infographic with rich colors | | Comic Book | Graphic novel panel with ink outlines and Ben-Day dots | | Isometric 3D | Isometric 3D-style boxes and depth | | Neon Sign | Glowing neon tubes on a dark brick wall | | Pastel Kawaii | Soft pastel palette with cute rounded forms | | Pixel Art | Retro 16-bit pixel art style | | Stained Glass | Cathedral stained glass with jewel tones | | Sticky Notes | Colorful sticky notes on a cork board | | Watercolor Artistic | Watercolor painting on textured paper |

Technical

| Preset | Description | |--------|-------------| | Blueprint | Architectural blueprint on deep blue background | | Dark Mode Technical | Engineering diagram on dark background | | Flat Material | Google Material Design flat UI style | | GitHub README | Markdown-friendly, repo architecture overview | | Photographic 3D | Photorealistic 3D render with glass and metal | | Terminal Hacker | Green-on-black phosphor CRT terminal | | Visionary Inspirational | Cosmic/futurist keynote aesthetic |

Retro & Fun

| Preset | Description | |--------|-------------| | Chalkboard | Classic green chalkboard with chalk texture | | Eccentric Psychedelic | Wild psychedelic maximum saturation | | Mad Genius | Chaotic beautiful-mind inventor's notebook | | Retro 80s Synthwave | Neon 1980s synthwave with grid lines | | Woodcut | Medieval woodcut/linocut print on parchment |

Language

| Preset | Description | |--------|-------------| | Bilingual Hebrew | English + Hebrew labels side by side | | Translated Hebrew | Fully translated to Hebrew with RTL layout |

Diagram Types

| Category | Types | |----------|-------| | Infrastructure | Network Diagram, Cloud Architecture, Kubernetes Cluster, Server Rack | | Software | System Architecture, Microservices Map, API Architecture, Database Schema | | Process | Flowchart, Decision Tree, Sequence Diagram, State Machine, CI/CD Pipeline | | Conceptual | Mind Map, Wireframe, Gantt Chart, Comparison Table, Org Chart |

Configuration

• API Key: Set FAL_KEY env var, or stored in ~/.config/nano-tech-diagrams/config.json
• Output Format: PNG (default), JPEG, or WebP
• Resolution: 0.5K, 1K (default), 2K, or 4K
• Aspect Ratio: auto (default), 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 9:21

Get a Fal AI API key at fal.ai.

License

MIT