smithery/ssujitx

nuitka-build

Build Python/PyQt6 apps into standalone executables using Nuitka

Installation

$ npx skills add smithery/ssujitx --skill nuitka-build

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery/ssujitx · top by installs.

npx skills add smithery/ssujitx

Browse all from smithery/ssujitx

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,090 B
  • docs SUMMARY.md 84 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

Nuitka Build Skill

Build ClawdBot UI into standalone executables for Windows and macOS using Nuitka.

What is Nuitka?

Nuitka compiles Python code to native C executables. Benefits:

  • Faster execution - Compiled to native code
  • No Python required - Standalone distribution
  • PyQt6 support - Built-in plugin
  • Cross-platform - Windows, macOS, Linux

Installation

pip install nuitka

Local Build Commands

Windows (Single .exe)

python -m nuitka --mode=onefile --enable-plugin=pyqt6 --windows-console-mode=disable --output-dir=dist main.py

Windows (Folder distribution)

python -m nuitka --mode=standalone --enable-plugin=pyqt6 --windows-console-mode=disable --output-dir=dist main.py

macOS (.app bundle)

python -m nuitka --mode=app --enable-plugin=pyqt6 --macos-app-icon=assets/clawdbot.png --output-dir=dist main.py

GitHub Actions with Nuitka-Action

Use Nuitka-Action for CI/CD builds.

Workflow Structure

- name: Build with Nuitka
  uses: Nuitka/Nuitka-Action@main
  with:
    nuitka-version: main
    script-name: main.py
    mode: onefile           # or standalone, app
    enable-plugins: pyqt6
    windows-console-mode: disable
    output-file: MyApp

Key Options

Option Values Description
mode onefile, standalone, app Output type
enable-plugins pyqt6, pyside6 UI framework
windows-console-mode disable, attach Hide console
windows-icon-from-ico Path Windows .ico icon
macos-app-icon Path macOS .png/.icns icon
output-file Name Output filename

Current Project Workflow

Located at: .github/workflows/build.yml

Triggers:

  • GitHub Release published
  • Manual (workflow_dispatch)

Builds:

Platform Mode Output
Windows onefile ClawdBot-Control-Panel-Windows.exe
macOS app ClawdBot-Control-Panel-macOS.app.zip

Steps:

  1. Checkout code
  2. Setup Python 3.13
  3. Install UV + dependencies
  4. Build with Nuitka-Action
  5. Upload artifacts + attach to release

Requirements

Windows

  • Visual Studio Build Tools OR MinGW64 (auto-downloaded by Nuitka)

macOS

  • Xcode Command Line Tools
  • xcode-select --install

Both

  • Python 3.13+
  • C compiler (auto-handled in GitHub Actions)

Common Issues

Missing DLLs (Windows)

Use --mode=standalone first to debug, then switch to --mode=onefile.

PyQt6 not found

Ensure --enable-plugin=pyqt6 is set.

Large file size

Normal for PyQt6 apps (~50-100MB). Nuitka includes Qt libraries.

Console window appears

Add --windows-console-mode=disable.

Tips

  1. Test locally first before pushing to GitHub Actions
  2. Use standalone mode for debugging
  3. Check build output for missing modules
  4. Add --show-progress for verbose local builds