FSF-Studio / README.md
Ardaosta's picture
Claude Sonnet 4.6
FSF Plasma Design Studio: layered composition, cuttability checks, FSF branding
b16e4fc
|
Raw History Blame Contribute Delete
2.7 kB
metadata
title: FSF Plasma Design Studio
emoji: 🔥
colorFrom: yellow
colorTo: gray
sdk: docker
app_port: 7860
pinned: false
short_description: Reference image to cut-ready DXF for Full Send Fabrication

FSF Plasma Design Studio

A web app for the client-facing design loop: reference image → auto-trace → real-world dimensions → DXF/SVG for the plasma table.

Built for Full Send Fabrication (Marshall) by Larame.

What it does

  1. Add a layer per reference image. Each layer is independently uploaded and segmented.
  2. Pick a per-layer mask mode:
    • Smart subject extraction (uses U-2-Net via rembg) gives a clean foreground silhouette regardless of lighting nuance. Best on photographs.
    • Auto threshold (Otsu) picks the optimal threshold automatically. Good on already-clean B&W reference art.
    • Manual threshold + blur + invert sliders for full control.
  3. Position and scale each layer on the panel canvas: drag to move, drag the orange handle to resize, or type exact inches into the editor.
  4. Set panel dimensions in inches (Width × Height).
  5. Click Compose & trace to combine all visible layers into a single panel-sized bitmap, trace it, and analyze it.
  6. Pick design intent (cutouts vs silhouette) and the analyzer flags cuttability problems:
    • Thin features below the minimum (default 0.1″ or 1.5× kerf, configurable) shown in red.
    • In silhouette mode, floating steel pieces not connected to the main piece (would fall out mid-cut) shown in orange.
  7. Download SVG (universal vector) or DXF (LWPOLYLINE on a CUT layer, R2010, inches) for the plasma table.

Run it

./run.sh

Then open http://127.0.0.1:5174.

First time only:

python3 -m pip install -r requirements.txt

Stack

  • Flask serves the single-page UI and the trace/analyze/export endpoints.
  • rembg (U-2-Net via ONNX Runtime) does subject extraction. Model auto-downloads to ~/.u2net/u2net.onnx on first use (~170MB).
  • potracer (pure Python Potrace port) does the auto-trace.
  • scipy.ndimage does the distance-transform (thin-feature detection) and connected-component labeling (floating-island detection).
  • ezdxf writes plasma-friendly DXF.
  • Pillow + numpy handle image prep.

No build step, no Node, no database. One command, runs offline.

DXF notes for Marshall's machine

Currently exports R2010 with LWPOLYLINE entities on a CUT layer, units inches, beziers flattened to 32-segment polylines. If his plasma software wants a different DXF flavor (R12, polyline arcs, splines, mm units, different layer name), the only thing that changes is export_dxf in app.py — the rest of the pipeline doesn't care.