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

Project Initialization

Scaffold a new project with your preferred frontend framework.

bash

pytron init <project_name> --template <framework> --provider <provider>

Supported templates: react, vue, svelte, next, solid, and more. Supported providers: npm, yarn, pnpm, bun.

Dependency Management

Manage Python dependencies in your project's virtual environment or proxy frontend commands.

bash

# Install from requirements.json
pytron install

# Install specific Python package
pytron install numpy

# Uninstall Python package
pytron uninstall numpy

# List installed Python packages
pytron show

# Proxy any npm/yarn/bun command to the frontend directory
pytron frontend install
pytron frontend run dev
pytron frontend --provider bun run build

Environment & Diagnostics

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

bash

# Run system diagnostics
pytron doctor

# Show environment info
pytron info

Run & Debug

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

bash

# Run with hot reload & frontend watch
pytron run --dev

# Run specific script
pytron run my_app.py

# Skip automatic frontend build
pytron run --no-build

# Run with specific engine
pytron run --engine chrome
# Shortcut for chrome engine
pytron run --chrome

Packaging

Create a standalone executable or installer.

bash

# Create standard executable
pytron package

# Package a specific script
pytron package custom_app.py --name "MyApp" --icon icon.ico

# Advanced Packaging Options
pytron package --secure      # Enable Rust Bootloader (Protects logic)
pytron package --fortress    # Enable Fortress Architecture (Hardened Core)
pytron package --nuitka      # Compile with Nuitka (Machine Code)
pytron package --installer   # Create Professional NSIS Installer
pytron package --pack        # Pack frontend assets into a single .pytron archive
pytron package --one-file    # Build single executable (default for Nuitka)
pytron package --one-dir     # Build folder distribution (default for PyInstaller)

Plugins

Manage application plugins.

bash

# Install a plugin from GitHub
pytron plugin install username.repo.version

# List installed plugins
pytron plugin list

# Scaffold a new plugin
pytron plugin create my-plugin-name

# Uninstall a plugin
pytron plugin uninstall my-plugin-name

Authentication

Manage GitHub credentials for private plugins and repositories.

bash

# Securely store GitHub credentials
pytron login

# Log out and remove stored credentials
pytron logout

Browser Engines

Manage browser engines for the runtime.

bash

# Install/Forge a browser engine
pytron engine install chrome

CI/CD Workflows

Generate workflow configurations for CI/CD environments.

bash

# CI/CD Workflow management
pytron workflow

Automated Documentation

Generate automated API documentation for your Pytron project.

bash

# Generate docs with default vibrant theme
pytron docs

# Generate docs to specific output dir with different theme
pytron docs --output ./my-docs --theme glass

Android (Experimental)

Initialize and build for Android devices. 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

# View Logcat
pytron android logcat

# Build Android App Bundle (.aab) for Google Play Store
pytron android build --aab

# Reset to initial state
pytron android reset