# modly | lightningpixel | Knowledge Base | Instagit

Desktop app to generate 3D models from images or prompt using local AI — runs entirely on your GPU

GitHub Stars: 6k

Repository: https://github.com/lightningpixel/modly

---

## Articles

### [Understanding the PythonBridge Class in Modly's Architecture](/lightningpixel/modly/pythonbridge-class-modly-architecture-role)

Discover the PythonBridge class in Modly's architecture. It manages the Python FastAPI backend from Electron, enabling communication between React frontend and AI inference services.

- Tags: internals
- Published: 2026-08-21

### [How Built-In Extensions Are Synchronized in the Modly Electron Main Process](/lightningpixel/modly/modly-builtin-extensions-synchronization-electron-main)

Learn how Modly synchronizes built-in extensions in the Electron main process. Discover the syncBuiltinExtensions function and app.whenReady event.

- Tags: internals
- Published: 2026-08-21

### [Modly Workflow Node Types: Source-Only vs Sink-Only Nodes Explained](/lightningpixel/modly/modly-workflow-node-types-source-sink)

Explore Modly workflow node types: Understand source-only (image, text, mesh) and sink-only (output, preview) nodes for efficient data flow. Optimize your pipelines today.

- Tags: deep-dive
- Published: 2026-08-21

### [How to Implement a GeneratorRegistry with Model Adapters in FastAPI](/lightningpixel/modly/implement-generatorregistry-model-adapters-fastapi)

Learn how to implement a dynamic GeneratorRegistry with Model Adapters in FastAPI. Discover, load, and manage 3D model adapters at runtime using Modly's plugin architecture.

- Tags: how-to-guide
- Published: 2026-08-21

### [How Modly Notifies the Renderer Process About Python Backend Crashes via IPC](/lightningpixel/modly/modly-notify-renderer-python-crashes-ipc)

Learn how Modly notifies the renderer process about Python backend crashes. It uses IPC and an exit listener on the FastAPI child process to send a python:crashed message.

- Tags: internals
- Published: 2026-08-21

### [How to Ensure Process Group Termination for Freeing Metal-Wired Memory on Unix in Electron Apps](/lightningpixel/modly/process-group-termination-free-metal-wired-memory-unix-electron)

Prevent GPU memory leaks in Electron apps on Unix. Learn to ensure process group termination and free Metal-wired memory by detaching child processes and killing the process group.

- Tags: how-to-guide
- Published: 2026-08-21

### [How Modly Resolves Python Executable Paths from Virtual Environments and System Python](/lightningpixel/modly/modly-resolve-python-executable-paths)

Learn how Modly finds Python executables from venv or system Python. It prioritizes user args, then virtual environments, and finally system Python for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-21

### [How Modly Handles Global Exception Handling and Logging in Electron](/lightningpixel/modly/modly-global-exception-handling-logging-electron)

Discover how Modly implements global exception handling and logging in Electron. Learn how it captures crashes, forwards them to the renderer, and records every runtime failure for robust diagnostics.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Create Custom Title Bars for Frameless Electron Apps on Windows and Linux](/lightningpixel/modly/custom-title-bars-frameless-electron-windows-linux)

Learn how to create custom title bars for frameless Electron apps on Windows and Linux. Implement drag regions and window controls using preload scripts and IPC.

- Tags: how-to-guide
- Published: 2026-08-21

### [How Extension Manifests Define Model and Process Extensions in Modly](/lightningpixel/modly/modly-extension-manifests-model-process-extensions)

Discover how Modly extension manifests use JSON to define AI models and custom processing logic. Learn about entry points, node behaviors, and metadata for seamless integration.

- Tags: internals
- Published: 2026-08-21

### [How to Implement a Typed IPC API Between Electron and Renderer Using Preload Scripts](/lightningpixel/modly/typed-ipc-api-electron-renderer-preload)

Learn to implement a typed IPC API between Electron and renderer using preload scripts. Expose strongly-typed objects with contextBridge for safe, IntelliSense-rich communication.

- Tags: how-to-guide
- Published: 2026-08-21

### [How Modly Manages Frontend Domains Using Zustand Stores: Architecture & Implementation](/lightningpixel/modly/modly-zustand-stores-frontend-domains)

Discover how Modly manages frontend domains with a centralized Zustand navigation store. Learn about its architecture and reactive domain switching implementation.

- Tags: architecture
- Published: 2026-08-21

### [State Management Solution in Modly: How Zustand Powers the Frontend](/lightningpixel/modly/modly-frontend-state-management-solution)

Discover how Modly leverages Zustand for efficient frontend state management. Experience type-safe global stores without the Redux boilerplate. Learn more about this powerful solution.

- Tags: deep-dive
- Published: 2026-08-21

### [How Modly Migrates Legacy Workflow Formats to the Node-Based System](/lightningpixel/modly/modly-migrate-legacy-workflow-formats)

Modly automatically migrates legacy block-list workflows to its node-based system. Discover how the migrateWorkflow function ensures seamless backward compatibility and modernizes your processes.

- Tags: migration-guide
- Published: 2026-08-21

### [How to Prevent Invalid Edge Connections in React Flow Using Constants](/lightningpixel/modly/prevent-invalid-edge-connections-react-flow-constants)

Prevent invalid React Flow edge connections by defining constants for strict type enforcement and validating handles in onConnect. Learn to safeguard your nodes effectively.

- Tags: how-to-guide
- Published: 2026-08-21

### [Modly Workflow JSON Structure: Complete Schema and Field Reference](/lightningpixel/modly/modly-workflow-json-structure)

Explore the Modly workflow JSON structure. Understand the complete schema and field reference for defining your workflows with nodes and edges.

- Tags: api-reference
- Published: 2026-08-21

### [How Modly Uses React Flow to Power Its Visual Workflow System](/lightningpixel/modly/modly-react-flow-visual-workflow-system)

Discover how Modly uses React Flow to build a powerful visual workflow system. Learn about custom nodes, connection validation, and history for a desktop grade editor.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Spawn and Manage a FastAPI Backend as a Subprocess in Electron](/lightningpixel/modly/spawn-manage-fastapi-subprocess-electron)

Learn how to spawn and manage a FastAPI backend as a subprocess within your Electron app. This guide covers using child_process, health checks, and graceful shutdown for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Manage Python Backend Lifecycle with PythonBridge in Electron: A Complete Guide](/lightningpixel/modly/manage-python-backend-lifecycle-pythonbridge-electron)

Manage your Python backend lifecycle in Electron with PythonBridge. Provision an interpreter, spawn a bridge, and terminate gracefully. Complete guide for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-21

### [How Modly Handles IPC Communication Between Electron Main and Renderer Processes](/lightningpixel/modly/modly-ipc-communication-electron-main-renderer)

Learn how Modly handles IPC communication between Electron main and renderer processes using a secure preload script and contextBridge for controlled API access.

- Tags: internals
- Published: 2026-08-21

### [Modly Desktop Application Architecture: A Deep Dive into Electron, React, and Python FastAPI](/lightningpixel/modly/modly-desktop-application-architecture)

Explore the Modly desktop application architecture, a three-tier system using Electron, React, and Python FastAPI. Understand its Node process, security layer, and UI separation.

- Tags: architecture
- Published: 2026-08-21

### [How Modly Uses Local AI Models for Image-to-3D Mesh Generation](/lightningpixel/modly/how-modly-uses-local-ai-image-to-3d-mesh)

Discover how Modly uses local AI models for image to 3D mesh generation. Run inference pipelines entirely on-device and export GLB files without cloud APIs.

- Tags: how-to-guide
- Published: 2026-08-21

### [How to Build a Cross-Platform Desktop App with Electron and FastAPI: Architecture and Implementation Guide](/lightningpixel/modly/how-to-build-cross-platform-desktop-app-electron-fastapi)

Build a cross-platform desktop app with Electron and FastAPI. Learn to run the FastAPI server as a subprocess, communicate via HTTP, and expose a type-checked API.

- Tags: architecture
- Published: 2026-08-21

### [How Modly's Logger Archives Sessions and Captures Information for Debugging Runtime Issues](/lightningpixel/modly/modly-logger-session-archiving-runtime-debugging)

Discover how Modly's custom logger archives sessions and captures essential information in timestamped folders to effectively debug runtime issues while managing disk space.

- Tags: how-to-guide
- Published: 2026-08-20

### [How to Package Modly for Apple Silicon macOS: 7 Core Requirements Explained](/lightningpixel/modly/modly-packaging-apple-silicon-macos-requirements)

Learn the 7 core requirements for packaging Modly for Apple Silicon macOS, including ARM64, Electron-builder config, and embedded Python for DMG installers.

- Tags: how-to-guide
- Published: 2026-08-20

### [How Modly Migrates Legacy Workflow Block Formats to the Modern Node/Edge Model](/lightningpixel/modly/modly-legacy-workflow-migration-block-format-transformation)

Modly seamlessly migrates legacy workflow block formats to the modern node edge model automatically. Discover how Modly ensures backward compatibility with its on-the-fly conversion.

- Tags: migration-guide
- Published: 2026-08-20

### [Modly Testing Strategies: How to Test Electron Preload APIs with Node's Native Runner](/lightningpixel/modly/modly-testing-strategies-electron-preload-api-testing)

Discover Modly's testing strategies. Learn how to test Electron preload APIs using Node's native runner and mock the IPC bridge for efficient, isolated testing without a full Electron instance.

- Tags: testing
- Published: 2026-08-20

### [How Modly's Mesh Smoothing and Decimation Works to Optimize 3D Assets](/lightningpixel/modly/modly-mesh-smoothing-decimation-optimized-output)

Discover how Modly optimizes 3D assets with mesh smoothing and decimation. Learn about Taubin, Laplacian, and quadric edge-collapse algorithms for clean, texture-preserving GLB outputs.

- Tags: internals
- Published: 2026-08-20

### [How Modly's API Layer Is Structured and How It Interfaces With the FastAPI Backend](/lightningpixel/modly/modly-api-layer-architecture-fastapi-interface)

Explore Modly's API layer architecture, including its FastAPI backend, modular routers, GeneratorRegistry, and BaseGenerator subclasses for efficient model inference.

- Tags: architecture
- Published: 2026-08-20

### [How Modly's Router Handles Navigation and State Preservation in React](/lightningpixel/modly/modly-router-navigation-state-preservation)

Discover how Modly's router manages navigation and state preservation with Zustand and React lazy loading. Keep your app state intact during transitions.

- Tags: internals
- Published: 2026-08-20

### [Modly Error Handling Strategy for Uncaught Exceptions in Main and Renderer Processes](/lightningpixel/modly/modly-error-handling-uncaught-exceptions-main-renderer)

Discover Modly's error handling strategy for uncaught exceptions. Learn how Modly logs and displays errors from main and renderer processes via IPC and toast notifications.

- Tags: best-practices
- Published: 2026-08-20

### [Performance Implications of Running Multiple Modly Extension Processes Concurrently](/lightningpixel/modly/modly-performance-concurrent-extension-processes)

Discover the performance implications of running multiple Modly extension processes. Understand memory scaling and crash isolation benefits to optimize your applications.

- Tags: performance
- Published: 2026-08-20

### [How Modly's Built‑in Sync Mechanism Works for Extensions in User Data Directories](/lightningpixel/modly/modly-builtin-sync-extension-user-data)

Discover how Modly synchronizes built-in extensions by copying them to your user data directory. Learn about its version-file comparison for efficient updates.

- Tags: internals
- Published: 2026-08-20

### [How to Create a Custom Modly Extension: Complete Guide to Manifest Fields and Required Structure](/lightningpixel/modly/modly-custom-extension-creation-manifest-fields)

Learn how to create a custom Modly extension. This guide covers the essential manifest fields id name type version author description entry and nodes plus specific model fields for successful development.

- Tags: how-to-guide
- Published: 2026-08-20

### [How Modly's CLI Communicates with a Running Instance and Polls for Workflow Execution](/lightningpixel/modly/modly-cli-instance-communication-workflow-polling)

Learn how Modly's CLI connects to a running instance using HTTP POST for jobs and GET for status updates. Understand Modly CLI workflow execution.

- Tags: how-to-guide
- Published: 2026-08-20

### [Modly React Flow Workflow Editor Architecture and Backend Integration Explained](/lightningpixel/modly/modly-react-flow-workflow-editor-architecture-backend-integration)

Explore Modly's React Flow workflow editor architecture. Learn about its Zustand state management, undo/redo history, and Python backend integration via Electron IPC.

- Tags: architecture
- Published: 2026-08-20

### [How Modly Auto-Updater Manages Updates for Packaged Applications Across Operating Systems](/lightningpixel/modly/modly-auto-updater-packaged-app-updates-cross-platform)

Learn how Modly's auto-updater handles packaged application updates across Windows, Linux, and macOS. Discover platform-specific update strategies for seamless patching.

- Tags: internals
- Published: 2026-08-20

### [How Modly's Settings Store Persists User Preferences and Handles Version Migration](/lightningpixel/modly/modly-settings-store-persistence-version-migration)

Discover how Modly's settings store persists user preferences via JSON files and handles version migration with automatic key remapping. Learn about atomic read-merge-write operations for seamless updates.

- Tags: internals
- Published: 2026-08-20

### [Modly Memory Management Strategy: How MemoryIndicator Tracks GPU and RAM Usage](/lightningpixel/modly/modly-memory-management-memoryindicator-gpu-ram-tracking)

Discover Modly's memory management strategy. Learn how MemoryIndicator tracks GPU and RAM usage to prevent crashes and provide live system resource visibility.

- Tags: internals
- Published: 2026-08-20

### [How Modly's Model Downloader Handles Large AI Models and Interrupted Downloads](/lightningpixel/modly/modly-model-downloader-large-models-interruptions)

Modly's model downloader streams large AI models chunk by chunk, efficiently handling interrupted downloads with stall monitoring and state management for reliable downloads.

- Tags: internals
- Published: 2026-08-20

### [How Modly's Artifact Registry Manages and Persists Generated 3D Meshes Across Sessions](/lightningpixel/modly/modly-artifact-registry-3d-mesh-persistence)

Discover how Modly's artifact registry manages and persists 3D meshes across sessions. Learn how Modly stores mesh files and JSON sidecars to survive restarts.

- Tags: internals
- Published: 2026-08-20

### [Modly Extension Path Guard Security: How It Prevents Path Traversal Attacks](/lightningpixel/modly/modly-extension-path-guard-security-path-traversal)

Modly's extension path guard prevents path traversal attacks. Learn how its identifier validation and root-confinement checks secure your extensions directory from malicious writes.

- Tags: security
- Published: 2026-08-20

### [How Modly Handles IPC Communication Between Electron Main and Renderer for Workflow Execution](/lightningpixel/modly/modly-ipc-electron-main-renderer-workflow-execution)

Learn how Modly manages IPC communication between Electron main and renderer processes for workflow execution. Discover its preload script architecture and subprocess streaming for seamless integration.

- Tags: internals
- Published: 2026-08-20

### [Modly Extension System Architecture: How Model Extensions Are Loaded and Validated](/lightningpixel/modly/modly-extension-system-architecture-validation-loading)

Explore Modly's extension system architecture. Learn how it safely loads and validates model extensions using a three-layer approach with atomic operations and path traversal protection.

- Tags: architecture
- Published: 2026-08-20

### [How Modly's PythonBridge Manages the FastAPI Backend Lifecycle and Crash Recovery](/lightningpixel/modly/modly-pythonbridge-fastapi-lifecycle-crash-recovery)

Learn how Modly's PythonBridge manages FastAPI backend lifecycle with health polling and crash recovery. Discover its robust subprocess monitoring and restart capabilities for reliable applications.

- Tags: internals
- Published: 2026-08-20

### [How the Image Node Loads and Prepares Images for Generation in Modly](/lightningpixel/modly/how-does-the-image-node-load-and-prepare-images-for-generation)

Learn how the Modly Image node loads, decodes, normalizes, and reshapes images into tensors for AI generation, preparing them efficiently for the Python backend.

- Tags: internals
- Published: 2026-08-20

### [How the Modly ForEachNode Handles Batch Processing of Assets: A Deep Dive](/lightningpixel/modly/how-does-the-foreachnode-handle-batch-processing-of-assets)

Discover how Modly's ForEachNode efficiently handles batch processing. Learn about pre-scanning, file lists, and optional iterator grouping for seamless asset management.

- Tags: deep-dive
- Published: 2026-08-20

### [How Workflow Edges Connect Nodes in the Modly Graph](/lightningpixel/modly/how-do-workflow-edges-connect-nodes-in-the-graph)

Discover how workflow edges connect nodes in the Modly graph using the WFEdge interface. Learn how Modly builds directed graphs for efficient execution and data flow.

- Tags: internals
- Published: 2026-08-20

### [How Modly Handles the "Add to Scene" Workflow Node: A Technical Deep Dive](/lightningpixel/modly/how-does-modly-handle-the-add-to-scene-workflow-node)

Learn how Modly handles the Add to Scene workflow node. This technical deep dive explains how Modly validates mesh inputs and pushes geometry to the 3D viewer.

- Tags: deep-dive
- Published: 2026-08-20

### [How Modly's Preload Script Exposes APIs to the Renderer Process in Electron](/lightningpixel/modly/how-does-the-preload-script-expose-apis-to-the-renderer)

Learn how Modly's preload script safely exposes Electron APIs to the renderer using contextBridge.exposeInMainWorld for secure application development.

- Tags: internals
- Published: 2026-08-20

### [How the `useGeneration` Hook Manages the Generation Lifecycle in Modly](/lightningpixel/modly/how-does-the-usegeneration-hook-manage-the-generation-lifecycle)

Discover how the Modly useGeneration hook manages your 3D generation lifecycle. Learn about job creation, progress polling, and cancellation for a seamless workflow.

- Tags: internals
- Published: 2026-08-20

### [How the useApi Hook Manages REST API Calls in Modly](/lightningpixel/modly/how-does-the-useapi-hook-manage-rest-api-calls-to-the-backend)

Discover how the useApi hook in Modly centralizes HTTP communication with its FastAPI backend using a pre-configured Axios instance and typed helper functions.

- Tags: how-to-guide
- Published: 2026-08-20

### [How the Modly CLI Agent Communicates with a Running Desktop App: HTTP API Architecture Explained](/lightningpixel/modly/how-does-the-modly-cli-agent-communicate-with-a-running-desktop-app)

Discover how the Modly CLI agent communicates with your desktop app. Explore the HTTP API architecture using FastAPI and REST for seamless integration.

- Tags: architecture
- Published: 2026-08-20

### [How Modly Integrates With ComfyUI for External Workflows: A Complete Guide](/lightningpixel/modly/how-does-modly-integrate-with-comfyui-for-external-workflows)

Learn how Modly integrates with ComfyUI for external workflows. Discover how Modly patches, executes, and routes ComfyUI workflows for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-20

### [How the Mesh Remesher Node Optimizes Polygon Count in Modly](/lightningpixel/modly/how-does-the-mesh-remesher-node-optimize-polygon-count)

Learn how Modly's Mesh Remesher node optimizes polygon count using explicit remeshing. Reduce mesh density and preserve geometry with configurable edge lengths and quad consolidation.

- Tags: internals
- Published: 2026-08-20

### [How the Mesh Exporter Node Handles GLB Export in Modly](/lightningpixel/modly/how-does-the-mesh-exporter-node-handle-glb-export)

Discover how the Modly Mesh Exporter node efficiently handles GLB export using glTF-Transform, preserving extensions and binary data without conversion. Learn the process now.

- Tags: internals
- Published: 2026-08-20

### [How the Mesh Repair Node Processes 3D Models in Modly](/lightningpixel/modly/how-does-the-mesh-repair-node-process-3d-models)

Learn how the Modly mesh repair node processes 3D models. It validates files, loads geometry, welds vertices, reduces polygon count with meshoptimizer, and outputs an optimized GLB file.

- Tags: internals
- Published: 2026-08-20

### [How the Extension Path Guard Protects Against Path Traversal in Modly](/lightningpixel/modly/how-does-the-extension-path-guard-protect-against-path-traversal)

Learn how Modly's extension path guard prevents path traversal vulnerabilities. It validates extensions and ensures paths stay within the root directory.

- Tags: security
- Published: 2026-08-20

### [How Modly Schedules and Executes Workflow Runs in FastAPI](/lightningpixel/modly/how-do-workflow-runs-get-scheduled-and-executed)

Learn how Modly schedules and executes workflow runs in FastAPI using background tasks for asynchronous processing and immediate run_id returns. Optimize your workflows now.

- Tags: internals
- Published: 2026-08-20

### [How Modly's Settings Store Persists and Synchronizes Configuration](/lightningpixel/modly/how-does-modlys-settings-store-persist-configuration)

Learn how Modly's settings store persists configuration using a JSON file and synchronous operations. Understand the getSettings and setSettings functions for reliable data management.

- Tags: internals
- Published: 2026-08-20

### [How IPC Communication Works Between Renderer and Main Process in Modly](/lightningpixel/modly/how-does-the-ipc-communication-work-between-renderer-and-main-process)

Learn how Modly's IPC communication works. Discover how renderer calls map to ipcRenderer invoke/send channels handled by ipcMain, secured by a preload script.

- Tags: internals
- Published: 2026-08-20

### [How Modly Handles GPU Memory Management During Generation: 3 Core Mechanisms Explained](/lightningpixel/modly/how-does-modly-handle-gpu-memory-management-during-generation)

Discover how Modly manages GPU memory during generation with its 3 core mechanisms: hardware detection, explicit cache clearing, and process restarts. Optimize your generation workflow today.

- Tags: internals
- Published: 2026-08-20

### [How the Modly Artifact Registry Service Works: A Deep Dive into IPC-Driven Asset Management](/lightningpixel/modly/how-does-the-artifact-registry-service-work)

Explore the Modly artifact registry service. Learn how IPC-driven asset management with path sandboxing and type classification secures your workspace assets.

- Tags: deep-dive
- Published: 2026-08-20

### [How Modly Manages Model Downloads and Caching: A Complete Technical Guide](/lightningpixel/modly/how-does-modly-manage-model-downloads-and-caching)

Discover how Modly manages model downloads and caching efficiently. Learn about lazy download on first use, streaming API with pause/cancel, and user-controlled storage for seamless model management.

- Tags: how-to-guide
- Published: 2026-08-20

### [How the Python Bridge Connects Electron and FastAPI in Modly: Complete Implementation Guide](/lightningpixel/modly/how-does-the-python-bridge-communicate-between-electron-and-fastapi)

Discover how the Python bridge connects Electron and FastAPI in Modly. Learn to route requests, forward logs, and handle crashes with this complete implementation guide.

- Tags: how-to-guide
- Published: 2026-08-20

### [How Modly's Extension System Supports External AI Models: A Complete Technical Guide](/lightningpixel/modly/how-does-modlys-extension-system-support-external-ai-models)

Discover how Modly's extension system supports external AI models by treating them as extensions. Learn about its discovery-and-loading pipeline for seamless integration.

- Tags: technical-guide
- Published: 2026-08-20

### [How the Workflow Node System Works in Modly: A Deep Dive](/lightningpixel/modly/how-does-the-workflow-node-system-work-in-modly)

Explore Modly's behavior-driven workflow node system. Learn how this graph architecture manages dependencies, async waits, and scene outputs for efficient execution.

- Tags: deep-dive
- Published: 2026-08-20

### [Design Patterns Used in Modly's Architecture: A Complete Technical Guide](/lightningpixel/modly/are-there-any-specific-design-patterns-used-in-modlys-architecture)

Explore Modly's architecture and discover the seven design patterns like Store Hook Plugin Mediator Facade Factory and Command that enable its modular reactive design for React and Electron.

- Tags: architecture
- Published: 2026-08-19

### [How Modly Handles State Management: Zustand Architecture and Store Patterns](/lightningpixel/modly/how-does-modly-handle-state-management)

Discover how Modly handles state management using Zustand architecture and domain-specific stores. Learn about selective localStorage persistence for efficient data handling in your web applications.

- Tags: architecture
- Published: 2026-08-19

### [Lightningpixel/Modly Project Structure: Electron, React, and FastAPI Architecture Explained](/lightningpixel/modly/what-is-the-overall-project-structure-of-lightningpixel-modly)

Explore the lightningpixel/modly project structure, a dual-runtime desktop app. Discover its Electron React frontend, Python FastAPI backend, and CLI tools architecture for image to 3D mesh conversion.

- Tags: architecture
- Published: 2026-08-19

### [How to Integrate Modly with Other Services via the REST API](/lightningpixel/modly/can-modly-be-integrated-with-other-services-via-its-api)

Integrate Modly with other services using its powerful FastAPI REST API. Submit jobs, manage workflows, and control functionality via standard HTTP endpoints for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-19

### [How Data Is Persisted in the Modly Backend: File-System Architecture Explained](/lightningpixel/modly/how-is-data-persisted-in-the-modly-backend)

Discover how Modly persists data using a file-system architecture. Learn how JSON sidecars replace traditional databases, making files the single source of truth.

- Tags: architecture
- Published: 2026-08-19

### [Modly Backend Technologies: A Complete Guide to the Python FastAPI Stack](/lightningpixel/modly/what-technologies-are-used-for-modlys-backend)

Explore Modly's backend technologies. Discover how this Python FastAPI stack, running locally in Electron, handles AI inference, mesh processing, and extensions with libraries like trimesh and huggingface_hub.

- Tags: architecture
- Published: 2026-08-19

### [Default Settings for Modly: Complete Configuration Reference](/lightningpixel/modly/what-are-the-default-settings-for-modly)

Discover Modly default settings for API endpoints file paths and 3D generation. Understand the configuration hierarchy CLI environment variables and settings.json.

- Tags: api-reference
- Published: 2026-08-19

### [How to Modify Modly's Settings Programmatically: A Complete Guide](/lightningpixel/modly/how-can-i-modify-modlys-settings-programmatically)

Learn how to modify Modly's settings programmatically using the setSettings function. This guide explains merging partial configurations into your JSON file.

- Tags: how-to-guide
- Published: 2026-08-19

### [How to Develop a New Extension for Modly: A Complete Guide](/lightningpixel/modly/how-do-i-develop-a-new-extension-for-modly)

Learn to develop a new Modly extension. Create a GitHub repo with a manifest file and entry script, then install it easily via the Models tab. Get started today.

- Tags: how-to-guide
- Published: 2026-08-19

### [Extension Points in Modly: Model and Process Extension Architecture Explained](/lightningpixel/modly/what-are-the-available-extension-points-in-modly)

Discover Modly's extension points: ModelExtension for AI integration and ProcessExtension for workflow nodes. Extend Modly functionality at runtime via the Extensions Store.

- Tags: architecture
- Published: 2026-08-19

### [How to Create and Customize Workflows in Modly: A Complete Guide](/lightningpixel/modly/how-can-i-create-or-customize-workflows-in-modly)

Master Modly workflows by learning to create and customize JSON-based pipelines. Assemble nodes and edges or register custom processors to build powerful data flows. Get the complete guide now.

- Tags: how-to-guide
- Published: 2026-08-19

### [Modly Workflow Definitions: Examples and JSON Structure Explained](/lightningpixel/modly/are-there-specific-examples-of-workflow-definitions-in-modly)

Explore Modly workflow definitions with clear examples and understand the JSON structure. Learn how to define, import, and version-control node graphs declaratively.

- Tags: how-to-guide
- Published: 2026-08-19

### [How App.tsx Orchestrates Workflow, Extension, Settings, and API Components in Modly](/lightningpixel/modly/how-does-app-tsx-tie-together-the-workflow-extension-settings-and-api-components)

Discover how App.tsx orchestrates Modly's workflow, extension, settings, and API components. Learn how this central bootstrap layer initializes state and renders the main layout.

- Tags: architecture
- Published: 2026-08-19

### [Modly Application Entry Point: How App.tsx Bootstraps the React UI](/lightningpixel/modly/what-is-the-main-entry-point-of-the-modly-application-app-tsx)

Discover how Modly's App.tsx bootstraps the React UI, orchestrating store, backend, and conditional rendering for a seamless application startup.

- Tags: internals
- Published: 2026-08-19

### [Modly API and Backend Architecture: Key Files and How They Work](/lightningpixel/modly/can-i-see-the-key-files-related-to-modlys-api-backend)

Explore Modly API and backend architecture. Discover key files like python-bridge.ts and main.py that manage generation, models, and IPC communication for seamless operation.

- Tags: architecture
- Published: 2026-08-19

### [How Modly Handles API Requests and Responses: A Deep Dive into the FastAPI Backend](/lightningpixel/modly/how-does-modly-handle-its-api-requests-and-responses)

Discover how Modly leverages FastAPI routers, Pydantic validation, background workers, and Server-Sent Events to efficiently manage API requests, responses, and large file downloads.

- Tags: deep-dive
- Published: 2026-08-19

### [Modly API Structure and Backend Architecture Explained](/lightningpixel/modly/what-is-the-structure-of-the-api-or-backend-for-modly)

Explore Modly's backend architecture. Discover its modular REST API, dynamic GeneratorRegistry, and FastAPI server embedded in the Electron client. Learn how Modly manages AI model extensions.

- Tags: architecture
- Published: 2026-08-19

### [Where Are Modly Configuration Files Located?](/lightningpixel/modly/where-are-the-configuration-files-for-modlys-settings-located)

Locate Modly configuration files easily. Find settings.json for Electron apps and CLI tools on Windows, Linux, and macOS for seamless Modly management.

- Tags: how-to-guide
- Published: 2026-08-19

### [How Settings Are Managed and Accessed in the Modly Application](/lightningpixel/modly/how-are-settings-managed-and-accessed-in-the-modly-application)

Learn how Modly manages and accesses settings securely. Discover how configuration paths and tokens are stored in a JSON file and accessed via pure functions and IPC handlers.

- Tags: internals
- Published: 2026-08-19

### [Extension System in Modly: Key Files and Architecture Explained](/lightningpixel/modly/what-are-the-key-files-related-to-the-extension-system-in-modly)

Explore Modly's extension system architecture and discover the key TypeScript files like electron.d.ts and extensionsStore.ts that power custom workflows. Understand how Modly manages extensions.

- Tags: architecture
- Published: 2026-08-19

### [How Extensions Integrate with the Main Application in Modly](/lightningpixel/modly/how-do-extensions-integrate-with-the-main-application-in-modly)

Discover how Modly extensions integrate seamlessly as first-class plug-ins using Electron IPC, preload APIs, and reactive stores for a powerful, coordinated application experience.

- Tags: internals
- Published: 2026-08-19

### [Understanding the Extension System Architecture in Modly: A Technical Deep Dive](/lightningpixel/modly/what-is-the-architecture-of-the-extension-system-in-modly)

Explore Modly's extension system architecture, a four-layer security model for safe JavaScript and Python plugin execution in Electron. Learn about manifest validation, sandboxing, IPC, and runtime.

- Tags: deep-dive
- Published: 2026-08-19

### [Where to Find Modly Workflow System Core Files: Architecture and File Paths](/lightningpixel/modly/where-can-i-find-the-core-files-for-the-workflow-system-in-modly)

Discover Modly workflow system core files in src/areas/workflows/ for runtime and UI logic. Learn about state management in src/shared/stores/workflowsStore.ts. Find Modly core files easily.

- Tags: architecture
- Published: 2026-08-19

### [How the Modly Workflow System Works: Node-Based Execution in lightningpixel/modly](/lightningpixel/modly/how-is-the-workflow-system-implemented-in-modly)

Discover how Modly's node-based execution engine builds AI pipelines using a DAG. Learn about its deterministic workflow and handling of branching, looping, and interactive pausing.

- Tags: internals
- Published: 2026-08-19

### [How Modly Workflow Runs Track Status and Handle Cancellation](/lightningpixel/modly/modly-workflow-runs-status-tracking-cancellation)

Learn how Modly workflow runs track progress and handle cancellation using its in-memory job dictionary, global cancellation set, and threading Events for robust control. Abort generation with the cancel endpoint.

- Tags: internals
- Published: 2026-08-15

### [How Modly Manages GPU Memory When Unloading and Reloading Models: A Deep Dive into the Source Code](/lightningpixel/modly/modly-gpu-memory-model-unloading-reloading)

Explore how Modly manages GPU memory for unloading and reloading models. Discover its layered strategy using Python GC, PyTorch CUDA cache, and OS adjustments for efficient memory control.

- Tags: deep-dive
- Published: 2026-08-15

### [How the Modly Export Endpoint Converts Between GLB, STL, and OBJ Formats](/lightningpixel/modly/modly-export-endpoint-format-conversion)

Learn how Modly's export endpoint converts GLB, STL, and OBJ formats. Discover its mesh-exporter processor and deterministic writers for seamless format conversion.

- Tags: how-to-guide
- Published: 2026-08-15

### [How Modly Handles Logging and Session Archiving in Its FastAPI Backend](/lightningpixel/modly/modly-logging-session-archiving)

Discover how Modly's FastAPI backend manages logging and session archiving. Learn about its custom logging filter and workspace directory for artifact storage. Explore the lightningpixel/modly repository.

- Tags: internals
- Published: 2026-08-15

### [How Modly Validates Extension Manifests: A Complete Technical Guide](/lightningpixel/modly/modly-extension-manifest-validation)

Discover how Modly validates extension manifests with its three-stage pipeline. Learn about integrity checks, semantic normalization, and trusted-source verification in this technical guide.

- Tags: how-to-guide
- Published: 2026-08-15

### [How Modly Handles Workspace Filesystem Persistence in lightningpixel/modly](/lightningpixel/modly/modly-workspace-filesystem-persistence)

Modly ensures workspace filesystem persistence by saving meshes textures and assets to a configurable local directory configurable via environment variable or REST API

- Tags: how-to-guide
- Published: 2026-08-15

### [How Modly Handles Extension Backup Creation During Upgrades](/lightningpixel/modly/modly-extension-backup-creation-upgrades)

Modly creates extension backups during upgrades by atomically renaming the current installation. This ensures a reliable rollback path if the new version fails to install.

- Tags: how-to-guide
- Published: 2026-08-15

### [IPC Channels Between Electron Renderer and Main Process in Modly: Complete Reference](/lightningpixel/modly/modly-electron-ipc-channels)

Explore Modly's IPC channels connecting Electron renderer and main processes. Understand typed preload bridges and API routing for efficient communication.

- Tags: api-reference
- Published: 2026-08-15

### [How Modly's Settings Store Persists and Synchronizes Configuration](/lightningpixel/modly/modly-settings-store-persistence-synchronization)

Discover how Modly persists configuration to a JSON file and synchronizes state across processes with IPC handlers. Ensure immediate reflection of changes in all renderer windows.

- Tags: internals
- Published: 2026-08-15

### [How Modly's Auto‑Updater Works in Its Electron Application](/lightningpixel/modly/modly-electron-app-auto-updater)

Discover how Modly's auto-updater leverages electron-updater for seamless updates in its Electron app. Learn about its handling of macOS builds, patch updates, and user prompts for major releases.

- Tags: internals
- Published: 2026-08-15

### [What Happens When a Mesh Is Smoothed or Decimated in Modly: A Deep Dive into the Optimization Pipeline](/lightningpixel/modly/modly-mesh-smoothing-decimation)

Discover how Modly optimizes meshes with smoothing or decimation, preserving UVs and materials through its advanced pipeline and intermediate files.

- Tags: deep-dive
- Published: 2026-08-15

### [How Modly Syncs Built‑in Extensions to the User Data Directory](/lightningpixel/modly/modly-builtin-extension-sync)

Learn how Modly syncs built-in extensions to the user data directory by comparing version markers and atomically copying files. Discover the syncBuiltinExtensions() function.

- Tags: internals
- Published: 2026-08-15

### [How the Modly Process Runner Manages Extension Subprocesses](/lightningpixel/modly/modly-process-runner-extension-subprocesses)

Learn how Modly manages extension subprocesses by isolating them in Python virtual environments and communicating via JSON. Discover the ExtensionProcess class and runner.py in this technical breakdown.

- Tags: internals
- Published: 2026-08-15

### [How Modly's Artifact Registry Manages Workspace Assets: Security, Classification, and IPC](/lightningpixel/modly/modly-artifact-registry-workspace-assets)

Discover how Modly's artifact registry secures, classifies, and manages workspace assets via path validation, auto-classification, and metadata extraction for efficient renderer process integration.

- Tags: internals
- Published: 2026-08-15

### [How to Use the Modly CLI for Automated Batch Processing: A Complete Guide](/lightningpixel/modly/modly-cli-automated-batch-processing)

Automate image-to-3D conversions with the Modly CLI. This guide shows you how to leverage the Modly CLI for efficient batch processing and streamline your workflow. Get started today.

- Tags: how-to-guide
- Published: 2026-08-15

### [How Modly Validates Workflow Wiring and Detects Invalid Node Connections](/lightningpixel/modly/modly-workflow-wiring-validation)

Modly validates workflow wiring with pre-flight analysis, detecting invalid node connections, missing inputs, and illegal merges before execution starts. Learn how.

- Tags: internals
- Published: 2026-08-15

### [How Modly Handles Resumable Downloads for AI Models: Architecture & Implementation](/lightningpixel/modly/modly-resumable-model-downloads)

Discover how Modly ensures robust AI model downloads with resumable functionality. Learn about its architecture and implementation for seamless interruption recovery.

- Tags: architecture
- Published: 2026-08-15

### [How Modly Integrates with HuggingFace for Model Downloads](/lightningpixel/modly/modly-huggingface-model-download-integration)

Learn how Modly integrates with HuggingFace for seamless model downloads. Modly uses huggingface_hub to fetch weights and stream files on demand.

- Tags: how-to-guide
- Published: 2026-08-15

### [How Modly's Extension Path Security Prevents Directory Traversal Attacks](/lightningpixel/modly/modly-extension-path-security-directory-traversal)

Discover how Modly's extension path security stops directory traversal attacks. Modly validates IDs and resolves paths within a root directory to keep your extension secure.

- Tags: security
- Published: 2026-08-15

### [How Modly Loads AI Models at Startup: The Generator Registry Discovery Process](/lightningpixel/modly/modly-generator-registry-model-loading)

Learn how Modly's GeneratorRegistry loads AI models at startup by scanning extensions, choosing import methods, and activating the selected model. Discover the Modly startup process.

- Tags: internals
- Published: 2026-08-15

### [How Modly's PythonBridge Communicates with the FastAPI Backend](/lightningpixel/modly/modly-pythonbridge-fastapi-communication)

Discover how Modly's PythonBridge connects your Electron app to a FastAPI backend. Learn how it translates IPC messages into REST API calls for seamless communication.

- Tags: internals
- Published: 2026-08-15

### [How Modly Installs Extensions from GitHub and Handles Backup/Restore](/lightningpixel/modly/modly-github-extension-installation-backup-restore)

Learn how Modly installs extensions from GitHub by cloning and renaming repositories. Discover its efficient backup and restore process using dot-prefixed folders.

- Tags: how-to-guide
- Published: 2026-08-15

### [What Is the Difference Between Model Extensions and Process Extensions in Modly?](/lightningpixel/modly/modly-model-vs-process-extensions)

Understand Modly model extensions vs process extensions. Model extensions run ML models in-process, while process extensions use separate subprocesses for scripts. Learn the key differences.

- Tags: deep-dive
- Published: 2026-08-15

### [How Modly Detects GPU Hardware and Manages CUDA Version Compatibility: A Technical Deep Dive](/lightningpixel/modly/modly-gpu-hardware-cuda-compatibility)

Learn how Modly detects GPU hardware and manages CUDA version compatibility using PyTorch APIs and environment variables. Ensures seamless extension compilation or CPU fallback.

- Tags: deep-dive
- Published: 2026-08-15

### [How Modly’s Python Subprocess Management Handles Startup, Health Checks, and Termination](/lightningpixel/modly/python-subprocess-management-startup-health-checks-termination)

Discover how Modly's Python subprocess management ensures reliable startup, health checks, and graceful termination with its ExtensionProcess class for robust application development.

- Tags: internals
- Published: 2026-08-15

### [How FastAPI Lifespan Handles Model Loading and Unloading in Modly](/lightningpixel/modly/fastapi-lifespan-management-model-loading-unloading)

Learn how FastAPI lifespan manages model loading and unloading in Modly, orchestrating adapter initialization and resource release for efficient operations.

- Tags: internals
- Published: 2026-08-15

### [Electron-Vite Configuration in Modly: How Preload and Renderer Processes Are Structured](/lightningpixel/modly/electron-vite-configuration-structure-preload-renderer-processes)

Learn how electron-vite configuration in Modly structures main, preload, and renderer processes with separate build targets and entry points to isolate the preload script from the React UI.

- Tags: internals
- Published: 2026-08-15

### [How Modly Installs Extensions from GitHub URLs: Cloning, Validation, and Atomic Deployment Workflow](/lightningpixel/modly/extension-install-github-url-workflow-clone-validate-repositories)

Learn how Modly installs extensions from GitHub URLs using a 12-step workflow that clones, validates manifests, and deploys atomically for reliable extension management.

- Tags: how-to-guide
- Published: 2026-08-15

### [How Process Extensions Communicate Progress and Logs to the Modly Main App](/lightningpixel/modly/process-extensions-communicate-progress-logs-main-app)

Discover how Modly process extensions send logs and progress updates to the main app using context object functions and IPC or stdout JSON.

- Tags: internals
- Published: 2026-08-15

### [How the RAM Indicator in the Top Bar Sources and Displays Memory Usage in Modly](/lightningpixel/modly/ram-indicator-top-bar-source-display-memory-usage)

Learn how the Modly RAM indicator sources and displays memory usage by polling Node.js APIs and rendering a color-coded progress bar. Understand your system's memory at a glance.

- Tags: internals
- Published: 2026-08-15

### [Extension Installation Path Validation Security: How Modly Prevents Directory Traversal Attacks](/lightningpixel/modly/security-measures-extension-installation-path-validation)

Discover how Modly secures extension installations with path validation, preventing directory traversal attacks through sanitization, confined path resolution, and reserved naming.

- Tags: security
- Published: 2026-08-15

### [How the Modly Settings Store Persists Configuration Across Sessions](/lightningpixel/modly/settings-store-persist-configuration-across-sessions)

Discover how Modly persists configuration across sessions using a JSON file in the user-data directory. Learn about getSettings and setSettings functions for seamless updates.

- Tags: internals
- Published: 2026-08-15

### [How the Modly UV Unwrapping System Uses BVH Acceleration Structures for Fast Triangle Queries](/lightningpixel/modly/uv-unwrapping-system-bvh-acceleration-structures)

Learn how the Modly UV unwrapping system uses BVH acceleration structures to speed up ray triangle intersection tests from O(N) to O(log N) for faster UV operations.

- Tags: internals
- Published: 2026-08-15

### [How Workspace Directory Management Serves Files Dynamically in Modly](/lightningpixel/modly/workspace-directory-management-serve-files-dynamically)

Modly dynamically serves 3D assets from WORKSPACE_DIR. Learn how path validation ensures security and enables runtime changes for efficient file management.

- Tags: how-to-guide
- Published: 2026-08-15

### [How Modly's `/export` Router Converts Mesh Data to GLB/GLTF Formats](/lightningpixel/modly/mesh-export-router-glb-gltf-formats)

Discover how Modly's /export router streams GLB/GLTF files by delegating conversion to the mesh exporter workflow node, utilizing Three.js for efficient mesh data export.

- Tags: internals
- Published: 2026-08-15

### [How the modly CLI Interfaces with a Running Desktop App via Canonical Commands](/lightningpixel/modly/modly-cli-interface-running-desktop-app-canonical-commands)

Discover how the modly CLI interacts with your desktop app using canonical commands. Learn about the FastAPI server and JSON-first automation for seamless integration.

- Tags: internals
- Published: 2026-08-15

### [How the Generator Registry Initializes and Manages AI Model Adapters in Modly](/lightningpixel/modly/generator-registry-initialize-manage-ai-model-adapters)

Discover how the Modly Generator Registry initializes and manages AI model adapters by discovering extensions, instantiating generators, and providing runtime APIs for model switching and hot-reloading.

- Tags: internals
- Published: 2026-08-15

### [FastAPI Backend Router Architecture in Modly: Generation, Model, Optimize, and Workflow_Runs Explained](/lightningpixel/modly/fastapi-backend-router-architecture-generation-model-optimize-workflow_runs)

Explore the Modly FastAPI backend router architecture: generation, model, optimize, and workflow_runs. Learn how it handles state and delegates tasks efficiently.

- Tags: architecture
- Published: 2026-08-15

### [How IPC Communication Handles Requests Between Renderer and Main Process in Modly](/lightningpixel/modly/ipc-communication-renderer-main-process-requests)

Learn how Modly's IPC communication manages renderer and main process requests using contextBridge, ipcRenderer, and ipcMain for seamless app interaction. Explore async RPC and one-way messaging.

- Tags: internals
- Published: 2026-08-15

### [How Modly Syncs Built-in Extensions from App Resources to the User Data Directory](/lightningpixel/modly/built-in-extension-sync-app-resources-user-data-directory)

Discover how Modly syncs built-in extensions from app resources to your user data directory on startup. Learn how this process ensures UI consistency and treats them like user-installed extensions.

- Tags: internals
- Published: 2026-08-15

### [How the Modly Desktop App Checks for and Applies Updates with the Auto‑Updater](/lightningpixel/modly/auto-updater-desktop-app-check-apply-updates)

Learn how the Modly desktop app uses electron-updater to automatically apply patch updates on macOS and Windows. Get insights into the auto-updater process and user prompts.

- Tags: how-to-guide
- Published: 2026-08-15

### [How the Artifact Registry Service Manages and Downloads Model Files in Modly](/lightningpixel/modly/artifact-registry-service-manage-download-model-files)

Discover how Modly's artifact registry service manages and downloads model files. Explore centralized storage, automatic Hugging Face downloads, and FastAPI endpoint exposure. Learn more!

- Tags: how-to-guide
- Published: 2026-08-15

### [How JS and Python Process Extensions Are Executed Differently in Modly's ProcessRunner](/lightningpixel/modly/js-python-process-extensions-execution-differences-processrunner)

Discover how Modly's ProcessRunner executes JS and Python extensions differently. Learn about persistent Node workers for JS and fresh subprocesses for Python, with distinct protocols and lifecycles.

- Tags: internals
- Published: 2026-08-15

### [How the Python Bridge Connects Electron Main Process to FastAPI Backend in Modly](/lightningpixel/modly/python-bridge-electron-main-process-fastapi-backend-communication)

Discover how the Python bridge in Modly connects Electron main process to a FastAPI backend. Learn about child process spawning, health checks, and seamless API communication.

- Tags: internals
- Published: 2026-08-15

### [How Modly's Extension System Architecture Works: Model vs Process Extensions Explained](/lightningpixel/modly/modly-extension-system-architecture-model-vs-process-extensions)

Understand Modly's extension system architecture. Learn how Model Extensions for AI generation and Process Extensions for custom scripts work differently via HTTP and local IPC.

- Tags: architecture
- Published: 2026-08-15