Command Line Interface

Pytron-kit includes a comprehensive CLI to manage the entire application lifecycle, from project initialization to production packaging.

Configuration (settings.json)

Configure every aspect of your application from a single source of truth.

json

{
  "title": "My App",
  "version": "1.0.0",
  "author": "Your Name",
  "description": "A brief description of your app",
  "copyright": "Copyright © 2026 Your Name",
  "pytron_version": "1.0.6",
  "dimensions": [800, 600],
  "min_size": null,
  "max_size": null,
  "resizable": true,
  "frameless": false,
  "fullscreen": false,
  "always_on_top": false,
  "transparent": false,
  "background_color": "#ffffff",
  "start_maximized": false,
  "start_hidden": false,
  "default_context_menu": false,
  "url": "./dist",
  "icon": "pytron.ico",
  "engine": "native",
  "single_instance": true,
  "close_to_tray": false,
  "debug": false,
  "frontend_framework": "react",
  "frontend_provider": "npm",
  "dev_port": null,
  "plugins_dir": null,
  "plugins": [],
  "crystal_mode": false,
  "virtual_entry_point": false,
  "splash_image": null,
  "force-package": [],
  "include_patterns": [],
  "exclude_patterns": [],
  "macos_plist": {},
  "signing": {}
}

engine: Choose the rendering engine: native (WebView2/WebKit) or chrome (Electron).
crystal_mode: Enable "Crystal Audit" High-Security Runtime surveillance.
virtual_entry_point: Enable the synthesized entry point strategy for enhanced obfuscation.
frontend_provider: Choose your default JS package manager: npm, yarn, pnpm, or bun.
single_instance: Ensure only one instance of your app can run at a time.
force-package: Ensure complex modules (like LLM libraries) are correctly bundled.

Commands

Initialize

Scaffold a new project with your preferred frontend framework.

bash

pytron init <project_name> --template <framework>

Supported templates: react, vue, svelte, next, solid, and more.

Install & Uninstall

Manage Python dependencies in your project's virtual environment.

bash

# Install from requirements.json
pytron install

# Install specific package
pytron install numpy

# Proxy any npm command to the frontend directory
pytron frontend install
pytron frontend run dev

# Use a different provider (yarn, pnpm, bun)
pytron frontend --provider yarn add lucide-react
pytron frontend --provider bun run dev
pytron frontend --provider pnpm build

# Uninstall package
pytron uninstall numpy

Environment & Diagnostics

Check your system for dependencies or show information about the current environment.

bash

# Run system diagnostic
pytron doctor

# Show environment info
pytron info

# List installed packages
pytron show

Run

Start the application. Use --dev for hot-reloading.

bash

# Run with hot reload
pytron run --dev

# Run specific script
pytron run my_app.py

Packaging

Create a standalone executable or installer. Use --secure for Agentic Shield or --nuitka for machine-code compilation.

bash

# Create standard executable
pytron package

# Pack with Agentic Shield (Encrypted)
pytron package --secure

# Compile with Nuitka (Machine Code)
pytron package --nuitka

# Create Professional Installer
pytron package --installer

Android (Experimental)

Initialize and build for Android devices. This command syncs your Python logic and frontend into a pre-configured Android project template.

bash

# Initialize Android project
pytron android init

# Sync frontend & python files into android folder
pytron android sync

# Build & Run on connected device
pytron android build
pytron android run

# Reset to initial state
pytron android reset