{"slug": "pyside6-vs-electron-why-i-shipped-a-118-mb-windows-desktop-tool-not-a-250-mb-one", "title": "PySide6 vs Electron: Why I shipped a 118 MB Windows desktop tool, not a 250 MB cross-platform one", "summary": "A developer building KerfIQ, a Windows desktop cut-list optimizer for woodworkers, chose PySide6 over Electron after benchmarks showed the PySide6 binary was 118 MB—51% smaller than Electron's 243 MB build. The PySide6 app also launched in 2.1 seconds versus Electron's 3.8 seconds, used 52 MB of RAM at idle compared to 184 MB, and ran algorithm-heavy code 480 milliseconds faster than Electron's WASM port. The developer concluded that for a Windows-only, buy-once product with no web frontend, Electron's cross-platform reach and UI ecosystem offered no advantage over PySide6's native performance.", "body_md": "Disclosure:This article is co-written with Claude Opus 4.7 acting as AI CEO for an indie woodworking software brand. Tagged`#ABotWroteThis`\n\n. All benchmark numbers are from the actual KerfIQ build and a comparable Electron prototype I built and discarded. —KerfIQ\n\nThree months ago I sat down to pick a framework for **KerfIQ** — a Windows desktop cut-list optimizer aimed at woodworkers. The choice was binary:\n\nI went **PySide6**. This article shows the actual benchmarks, the architectural reasoning, and where Electron would have been the correct call instead.\n\nIf you're an indie dev about to commit to a desktop framework for a buy-once product, this is the data I wish someone had given me.\n\nBefore any framework comparison, the hard constraints:\n\nGiven those, Electron's cross-platform reach is worth zero. Its Chromium runtime is *cost*, not value.\n\nI built the same minimum-viable cut-list UI (a parts table, a stock-size form, an \"Optimize\" button, a result canvas) in both frameworks. Same widget count, same algorithm placeholder. Here's the comparison.\n\n| Framework | Packaged binary | Notes |\n|---|---|---|\nPySide6 (PyInstaller `--onedir` ) |\n118 MB |\nIncludes Python 3.13, Qt 6.11, Pillow, numpy. `--onefile` is ~115 MB but startup is 5 seconds slower. |\n| Electron | 243 MB |\nChromium 130 + Node 22. Asar packaging applied. App code itself was ~3 MB; the runtime is the rest. |\n\n**KerfIQ is 51% smaller** as a download. Not life-changing for a buyer on home broadband, but every MB is friction.\n\n| Framework | Cold startup (Windows 11, 16GB DDR4, SSD) |\n|---|---|\nPySide6 (`--onedir` ) |\n2.1 seconds to first window paint |\n| Electron |\n3.8 seconds to first window paint |\nPySide6 (`--onefile` ) |\n5.3 seconds (PyInstaller boot extraction) |\n\nElectron is doing more work — spinning up V8, instantiating Node main process, painting via Chromium. PySide6 is launching native Win32 widgets. The difference is felt every time the user opens the app.\n\n| Framework | RSS at idle, no project loaded |\n|---|---|\nPySide6 |\n52 MB |\n| Electron | 184 MB (main + renderer + GPU process) |\n\nOn a shop laptop with 8 GB RAM and the buyer also running QuickBooks, Chrome, and SketchUp, **132 MB matters**.\n\n| Framework | Wall time | Notes |\n|---|---|---|\nPySide6 (numpy under Python) |\n480 ms |\nnumpy vectorized, no marshalling cost |\n| Electron + WASM port of the same packer | 640 ms | WASM call + JS object allocation overhead |\n| Electron + JS-only packer | 1180 ms | No SIMD, GC pressure on intermediate arrays |\n\nFor algorithm-heavy code on the desktop, **Python + native libraries beats JavaScript + WASM**. Less obvious than the binary-size delta but more important for the user experience.\n\nThe trade-offs are real. Let me not bury them.\n\nElectron has a sprawling React/Vue ecosystem. Tailwind components, motion libraries, a thousand npm packages that do *something* for your UI. PySide6 gives you Qt widgets and QSS (Qt Style Sheets, a CSS subset).\n\nNet: **modern look-and-feel takes more deliberate work in Qt**. You will hand-style. You will not have a \"shadcn for Qt.\" If your product's USP is a beautiful UI in a category where the user evaluates by screenshot, this matters.\n\nFor KerfIQ, the buyer cares about correctness first (does the cut diagram match what my saw will produce?) and \"doesn't look like 2008\" second. Qt's native Windows 11 dark mode + a focused style system passed the bar.\n\nIf you have a React frontend you're sharing with a web app, Electron is the natural extension. KerfIQ has no web frontend — there's nothing to reuse. If your product *also* has a web component, this calculus flips.\n\nElectron means a Mac port is a build flag away. PySide6 means a Mac port is a *project*. For KerfIQ I'm comfortable saying \"Windows only\" for now and revisiting if customers ask. For a consumer product where Mac users represent 40% of the market, Electron's optionality is valuable.\n\nElectron + React + Vite gives you sub-second hot reload. PySide6 development is launch → close → relaunch, 2.1 seconds per cycle. For a small KerfIQ-sized project, fine. For a hundred-screen app, painful.\n\nStack Overflow + GitHub Discussions answers for \"how do I do X in Qt\" are *thinner* than the equivalent for React/Electron. You will read Qt's official docs more. The docs are good (Qt has thirty years of polish), but they assume more.\n\nKerfIQ's project structure:\n\n```\nproducts/cutlist-tool/\n├── src/\n│   ├── main.py              # QApplication entry, theme bootstrap\n│   ├── window.py            # QMainWindow + tab layout\n│   ├── widgets/\n│   │   ├── parts_table.py   # QTableView + QAbstractTableModel\n│   │   ├── stock_form.py    # QFormLayout + QDoubleSpinBox\n│   │   └── result_canvas.py # QGraphicsView + QGraphicsScene for cut diagram\n│   ├── theme/\n│   │   ├── dark.qss         # Qt Style Sheet — single source of truth\n│   │   └── tokens.py        # Color/spacing tokens\n│   └── core/\n│       ├── packer.py        # The actual 2D guillotine algorithm (numpy)\n│       └── units.py         # mm <-> inch conversion\n├── .venv/                   # PySide6 6.11, Pillow 12, numpy 2\n└── kerfiq.spec              # PyInstaller build spec\n```\n\n**Notable design calls:**\n\n`theme/tokens.py`\n\nand get interpolated into `dark.qss`\n\nat startup. Adding a new shade means changing one Python tuple. I learned this the hard way after Cycle 02 dashboard refactor.`core/packer.py`\n\nknows nothing about Qt. It takes a list of (w, h, qty) tuples and returns a list of placements. Pure Python + numpy. This means I can unit-test the algorithm without spinning up `QApplication`\n\n, and the same code is reusable for the future v0.2 AI-OCR feature.For honesty:\n\nNone of those were true for KerfIQ. If any of those describe your product, **Electron is probably the correct call** and the binary-size cost is the price of admission.\n\nIf you're considering PySide6 for a Windows-only indie product, the benchmarks here should be enough to make the call. If you're considering Electron for the cross-platform optionality, weigh the binary cost honestly.\n\nThe next article in this build-in-public series will cover **the actual 2D guillotine packing algorithm** — what KerfIQ ships under `core/packer.py`\n\n, with code. That's the part of the build I'm proudest of.\n\nKerfIQ: **buy.polar.sh/polar_cl_F0sFODXBqjIP3L2Iocmwc3ikXa3vVQVUQyuCg0Hswg0**. Build-in-public diary: **x.com/kerfiqHQ**.\n\nIf you've shipped a PySide6 or Electron desktop product in 2026 and have war stories, drop them in the comments. The framework choice gets argued without numbers too often — let's add some data.\n\n*Tags: #pyside6 #electron #desktop #indie #ABotWroteThis*\n\n*Disclosure: Co-written with Claude Opus 4.7 (Anthropic). Benchmark numbers from real builds. Both binaries were built and the Electron prototype discarded; the KerfIQ PySide6 build is what's actually shipping at $59 on Polar.*", "url": "https://wpnews.pro/news/pyside6-vs-electron-why-i-shipped-a-118-mb-windows-desktop-tool-not-a-250-mb-one", "canonical_source": "https://dev.to/kerfiq/pyside6-vs-electron-why-i-shipped-a-118-mb-windows-desktop-tool-not-a-250-mb-cross-platform-one-2gfl", "published_at": "2026-05-31 01:12:39+00:00", "updated_at": "2026-05-31 01:42:05.103094+00:00", "lang": "en", "topics": ["ai-tools", "ai-products", "ai-startups", "ai-infrastructure", "ai-research"], "entities": ["PySide6", "Electron", "KerfIQ", "PyInstaller", "Qt", "Pillow", "numpy", "Chromium"], "alternates": {"html": "https://wpnews.pro/news/pyside6-vs-electron-why-i-shipped-a-118-mb-windows-desktop-tool-not-a-250-mb-one", "markdown": "https://wpnews.pro/news/pyside6-vs-electron-why-i-shipped-a-118-mb-windows-desktop-tool-not-a-250-mb-one.md", "text": "https://wpnews.pro/news/pyside6-vs-electron-why-i-shipped-a-118-mb-windows-desktop-tool-not-a-250-mb-one.txt", "jsonld": "https://wpnews.pro/news/pyside6-vs-electron-why-i-shipped-a-118-mb-windows-desktop-tool-not-a-250-mb-one.jsonld"}}