modelbeast/.gitignore
m3ultra 4bc2f56d34 README: local-first rewrite + ignore the .env.* family
The README still read as a fal.ai front-end with a local afterthought: the headline
`mb` example ran fal_trellis2, the "recommended chain for best image→3D" was four
fal_* calls, and the operator table listed 5 local ops against 9 cloud ones. That is
backwards now — 22 of the 31 operators run entirely on the fleet.

It also predated most of what we have: the whole audio/video/text suite (tts_local,
stt_local, voice_clone_local, music_local, lipsync_local, wan_video, llm_local,
motion_local), comfyui_sd, flux_local, mflux_image_edit, seedvr2_upscale and
bg_remove_local were all missing from the catalog entirely.

- lead with local; cloud demoted to its own opt-in "costs real money" section
- all 31 operators documented, grouped by what you're trying to make
- recommended chain is now local: bg_remove_local -> [seedvr2_upscale] -> trellis_mac
  (quality) or hunyuan3d_mlx (faster, ~3x lighter, the only one that runs on M1)
- setup section reordered: most local ops need nothing, hunyuan3d_mlx needs no HF
  login at all, only sf3d/trellis_mac/bg_remove_local are gated
- lanes corrected: gpu+cpu are a NODE POOL (gpu 1/node, cpu per-node cpu_slots),
  not the old flat "gpu=1, cpu=3, net=6"
- manifest `python` documented as repo-relative (remote nodes can't resolve absolute)
- link PERFCHECK.md; drop the stale "on the M3 Ultra" framing — it's a fleet
- verified: every operator on disk appears, no phantom ids, no broken doc links

Also: .gitignore had `*.env` and `.env`, neither of which matches a suffixed name
like `.env.remote` — which is sitting un-ignored in the m1's checkout right now, one
`git add -A` away from being committed. Ignore the `.env.*` family (keeping
.env.example committable). Nothing has leaked: no .env file is tracked.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-17 22:25:08 +10:00

54 lines
1.2 KiB
Plaintext

# Runtime data (assets, jobs, db) — never commit
data/
# Python
.venv/
venvs/
__pycache__/
*.pyc
.python-version
# Node / frontend build
web/node_modules/
web/dist/
# Secrets & local config
*.env
.env
# `.env` matches only the exact name and `*.env` only matches names ENDING in .env — neither
# catches a suffixed one like `.env.remote` (which sits un-ignored on the m1 today). Secrets
# live in .env files by convention here, so ignore the whole family; keep examples committable.
.env.*
!.env.example
server/.env
# Large model weights / caches
models/
*.safetensors
*.ckpt
*.pt
# Compiled native helpers (source is committed, binary is not)
bin/objcap
bin/*.o
# OS
.DS_Store
vendor/
# Brush runtime autotune cache
target/
# Brush prebuilt binary (reinstall via scripts/install_brush.sh)
bin/brush
bin/brush-app-aarch64-apple-darwin/
# GPU worker-pool config — primary only (a leaf worker must NOT have this)
nodes.json
# perfcheck runtime state — per-runner, not shared. The authoritative copy lives on the
# m4mini watchdog; baselines.json is derived from history.jsonl and regenerated each run.
scripts/perfcheck/history.jsonl
scripts/perfcheck/baselines.json
scripts/perfcheck/pending.json