Release/v0.4.0

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,61 @@
+name: 🐞 Bug report
+description: Create a report to help us improve
+labels: [bug, "pending triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **Before You Start...**
+
+        This form is only for submitting bug reports. Before opening one, please:
+        - Search existing issues — your problem may already be reported or fixed in the dev branch.
+        - For usage questions, join the [Discord Chat](https://discord.gg/T7uQJWnNgr).
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the bug
+      description: A clear and concise description of what the bug is.
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. Go to '...'
+        2. Click on '...'
+        3. See the error
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Modly version
+      description: Which version of Modly are you running? (Help → About, or package.json)
+      placeholder: 0.3.5
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      placeholder: Windows 11 / macOS 14 (arm64) / Ubuntu 24.04
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Screenshots & logs
+      description: Add screenshots and any relevant log output to help explain the problem.
+    validations:
+      required: false
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Confirmation
+      options:
+        - label: I have searched existing issues and this has not been reported yet.
+          required: true
+        - label: I can reproduce this on the latest version of Modly.
+          required: true

.github/ISSUE_TEMPLATE/bug_report_extension.yml

@@ -0,0 +1,80 @@
+name: 🧩 Bug report — Official extension
+description: Report a bug in one of Modly's official extensions
+labels: [bug, extension, "pending triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **Before You Start...**
+
+        This form is only for bugs in **official extensions** shipped with Modly.
+        For core app bugs, use the regular *Bug report* instead.
+        - Search existing issues — your problem may already be reported or fixed in a newer version.
+        - Make sure the extension is up to date — **extensions do not update automatically**, so a fix may already be available in a newer version.
+        - Try to **repair** the extension, or **uninstall and reinstall** it — this fixes most issues.
+        - For usage questions, join the [Discord Chat](https://discord.gg/T7uQJWnNgr).
+  - type: input
+    id: extension
+    attributes:
+      label: Which official extension?
+      description: Name of the official extension affected.
+      placeholder: e.g. modly-hunyuan3d-mini-extension
+    validations:
+      required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the bug
+      description: A clear and concise description of what the bug is.
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. Open the extension '...'
+        2. Apply '...'
+        3. See the error
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Modly version
+      description: Which version of Modly are you running? (Help → About, or package.json)
+      placeholder: 0.3.5
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      placeholder: Windows 11 / macOS 14 (arm64) / Ubuntu 24.04
+    validations:
+      required: true
+  - type: input
+    id: gpu
+    attributes:
+      label: GPU
+      description: Which GPU are you using? (Modly runs locally on your GPU)
+      placeholder: e.g. NVIDIA RTX 4070 / Apple M3 / AMD RX 7800 XT
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Screenshots & logs
+      description: Add screenshots and any relevant log output to help explain the problem.
+    validations:
+      required: false
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Confirmation
+      options:
+        - label: I have searched existing issues and this has not been reported yet.
+          required: true
+        - label: I can reproduce this on the latest version of Modly.
+          required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 💬 Discord Chat
+    url: https://discord.gg/T7uQJWnNgr
+    about: Ask questions and chat with the Modly community in real time.
+  - name: ❤️ Sponsor Modly
+    url: https://github.com/sponsors/lightningpixel
+    about: Love Modly? Please consider supporting development via GitHub Sponsors.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,38 @@
+name: ✨ Feature request
+description: Suggest a new feature or improvement for Modly
+labels: [enhancement, "pending triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **Before You Start...**
+
+        Please search existing issues first — your idea may already be proposed.
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem does this solve?
+      description: Is your feature request related to a problem? Describe it.
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: Describe the solution or feature you'd like.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Any alternative solutions or workarounds you've considered.
+    validations:
+      required: false
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Confirmation
+      options:
+        - label: I have searched existing issues for this feature.
+          required: true

.gitignore

@@ -13,6 +13,8 @@ api/*.pyc
 api/**/*.pyc
 api/.venv/
 api/venv/
+tools/modly-cli/__pycache__/
+.hermes-e2e/
 
 # Models (heavy, downloaded at runtime)
 /models/
@@ -33,3 +35,9 @@ Thumbs.db
 .env
 .env.local
 
+# TypeScript incremental build output
+*.tsbuildinfo
+
+# Local dev helpers
+install.bat
+launch.bat

README.md

@@ -6,7 +6,7 @@
 
 **Local, open source, AI-powered image-to-3D mesh generation.**
 Turn any photo into a 3D model using open source AI models running entirely on your GPU.
-Modly is a desktop application for Windows and Linux (macOS coming soon)
+Modly is a desktop application for Windows, Linux, and Apple Silicon macOS.
 
 > Created by [Lightning Pixel](https://github.com/lightningpixel)
 
@@ -19,15 +19,15 @@ Modly is a desktop application for Windows and Linux (macOS coming soon)
 
 ## Download
 
-Head to the [Releases](../../releases/latest) page to download the latest installer for Windows or Linux.
+Head to the [Releases](../../releases/latest) page to download the latest installer for Windows, Linux, or Apple Silicon macOS.
 
 Alternatively, you can clone the repository and run the app directly without installing:
 
 ```bash
 # Windows
-launcher.bat
+launch.bat
 
-# Linux
+# Linux / macOS
 ./launcher.sh
 ```
 
@@ -59,11 +59,28 @@ pip install -r requirements.txt
 npm run dev
 ```
 
+### 4. Test
+
+```bash
+npm test
+./node_modules/.bin/tsc --noEmit -p tsconfig.node.json
+npm run build
+```
+
+## Platform notes
+
+- macOS support targets Apple Silicon only.
+- macOS uses native window controls. Windows and Linux keep the existing custom controls.
+- The top bar includes a live RAM indicator sourced from the main process.
+- Workflow wiring is validated before run; invalid graphs stay in place and surface inline/toast warnings instead of dropping the current mesh view.
+- Package Apple Silicon macOS with `npm run package:mac`.
+- Imported meshes can be smoothed and decimated in-app; optimized results are written back into the workspace.
+
 ---
 
 ## Extension system
 
-Modly supports external AI model extensions. Each extension is a GitHub repository containing a `manifest.json` and a `generator.py`.
+Modly supports external model and process extensions. Each extension is a GitHub repository containing a `manifest.json` plus the runtime entry files required by its type.
 
 ### Official extensions
 
@@ -85,20 +102,36 @@ Modly supports external AI model extensions. Each extension is a GitHub reposito
 
 ![Enter extension URL](docs/install-extension.png)
 
-**3.** Once the extension is installed, download the model or one of its variants.
+**3.** If the extension exposes model nodes, download the model or one of its variants. Process extensions are ready once installation and setup complete.
 
 ![Install models](docs/install-models.png)
 
 ---
 
-### Community 
+## Modly CLI
 
-Join the [Discord server](https://discord.gg/BvjDCvS3yr) to stay up to date with the latest news, report bugs, and share feedback.
+Agents and scripts can call a running Modly desktop app without using the UI via the stdlib-only CLI. The CLI is a thin helper over Modly's canonical automation concepts and keeps final machine-readable JSON on stdout:
 
-Follow Modly and its development on X:
+```bash
+python tools/modly-cli/agent.py health
+python tools/modly-cli/agent.py model list
+python tools/modly-cli/agent.py workflow-run status <run_id>
+python tools/modly-cli/agent.py generate --image ./input.png --output ./export.glb
+```
 
-- [Modly on X](https://x.com/modly3d)
-- [Lightning Pixel on X](https://x.com/lightningpiixel)
+Canonical commands are `health`, `model`, `workflow-run`, `capability`, and `process-run`. The friendly `generate` command starts `POST /workflow-runs/from-image`, polls the returned run, exports the final mesh when requested, and includes recovery metadata such as `workflow-run status ...` and `workflow-run cancel ...` in the JSON response.
+
+Compatibility and helper surfaces are intentionally separated: `legacy` wraps old `/generate/*` job endpoints, `dev serve-api` / `dev ensure-server` start only the FastAPI backend and do not prove Electron/Desktop bridge readiness, and `experimental comfy-image` / `experimental generate-from-workflow` are external ComfyUI orchestration helpers rather than the canonical Modly agent contract. Hidden helper aliases such as `status`, `export`, and `batch` remain parseable for scripts, but they are not presented as canonical root commands.
+
+`experimental generate-from-workflow --workflow <name> --output <path>` treats `--output` as the final artifact location. When the ComfyUI workflow produces a downloadable 3D asset, the CLI downloads it directly; image-only workflows remain a compatibility path through Modly image-to-3D generation.
+
+See `tools/modly-cli/SKILL.md` for the agent workflow and output contract.
+
+---
+
+### Community
+
+Join the [Discord server](https://discord.gg/BvjDCvS3yr) to stay up to date with the latest news, report bugs, and share feedback.
 
 ---
 

api/main.py

@@ -9,7 +9,7 @@
 from fastapi.responses import FileResponse
 from fastapi import HTTPException
 
-from routers import generation, model, optimize, status, settings, extensions, export, workflow_runs
+from routers import generation, model, optimize, status, settings, extensions, export, workflow_runs, agent
 
 
 @asynccontextmanager
@@ -31,7 +31,7 @@ def filter(self, record):
 
 app = FastAPI(
     title="Modly API",
-    version="0.3.6",
+    version="0.4.0",
     lifespan=lifespan,
 )
 
@@ -40,6 +40,9 @@ def filter(self, record):
     allow_origins=["*"],
     allow_methods=["*"],
     allow_headers=["*"],
+    # drei's SplatLoader reads Content-Length to size its buffers; cross-origin
+    # JS can only see it when the server explicitly exposes the header.
+    expose_headers=["Content-Length"],
 )
 
 app.include_router(status.router)
@@ -50,6 +53,7 @@ def filter(self, record):
 app.include_router(extensions.router, prefix="/extensions")
 app.include_router(export.router,          prefix="/export")
 app.include_router(workflow_runs.router,   prefix="/workflow-runs")
+app.include_router(agent.router)
 
 # Serve generated files from workspace — dynamic so path changes take effect immediately
 @app.get("/workspace/{full_path:path}")