ReddRadar
Agent skill
castella-packaging
Package Castella applications for distribution using ux, PyInstaller, or Nuitka. Create executables, macOS app bundles, and cross-compile for other platforms.
Install this agent skill to your Project
npx add-skill https://github.com/i2y/castella/tree/main/skills/castella-packaging
SKILL.md
Castella App Packaging
When to use: "package Castella app", "create executable", "bundle for distribution", "macOS app bundle", "code signing", "cross-compile"
ux (Recommended)
ux creates single executables using uv. End users don't need Python installed.
Installation
uv tool install ux-py
Basic Usage
ux bundle --project . --output ./dist/
Configuration (pyproject.toml)
[tool.ux]
entry = "your_app"
include = ["assets/"]
[tool.ux.macos]
icon = "assets/icon.png"
bundle_identifier = "com.example.yourapp"
bundle_name = "Your App"
macOS App Bundle
# Signed .app bundle
ux bundle --format app --codesign --output ./dist/
# With DMG
ux bundle --format app --codesign --dmg --output ./dist/
# With notarization
ux bundle --format app --codesign --notarize --dmg --output ./dist/
Cross-Compilation
ux bundle --target linux-x86_64 --output ./dist/
ux bundle --target windows-x86_64 --output ./dist/
Supported Targets
| Target | PyPI |
|---|---|
| darwin-x86_64 | Yes |
| darwin-aarch64 | Yes |
| linux-x86_64 | Yes |
| linux-aarch64 | GitHub |
| windows-x86_64 | Yes |
PyInstaller
Alternative bundler:
uv add --dev pyinstaller
uv run pyinstaller --onefile --windowed your_app.py
Nuitka
Compiles Python to native code:
uv add --dev nuitka
uv run nuitka --standalone --onefile --disable-console your_app.py
Reference
docs/packaging.md- Full packaging documentation
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
i2y/castella
castella-agent-ui
Build chat interfaces and agent management UIs with Castella. Create chat components, display tool calls, manage multiple agents, and build agent hubs.
i2y/castella
castella-core
Build desktop, web, or terminal UIs with Castella. Create widgets, components, layouts, manage reactive state, handle events, and use the theme system.
i2y/castella
castella-a2a
Connect to A2A protocol agents from Castella. Communicate with agents, display agent cards, send messages, handle responses, and stream results.
i2y/castella
castella-mcp
Enable AI agents to introspect and control Castella UIs via MCP. Create MCP servers, expose UI resources, handle MCP tools, and use semantic IDs.
i2y/castella
castella-a2ui
Render A2UI JSON as native Castella widgets. Parse A2UI messages, handle actions, progressive rendering, data binding, and connect to A2UI-enabled agents.
elevanaltd/octave-mcp
octave-ultra-mythic
Ultra-high density compression using mythological atoms and semantic shorthand for OCTAVE (Olympian Common Text And Vocabulary Engine). Preserves soul and constraints at 60% compression for identity transmission, binding protocols, and extreme token scarcity.
Didn't find tool you were looking for?