| # `code/` — the scripts, as run |
|
|
| | file | what it does | |
| |---|---| |
| | `build310.py` | **The working environment builder.** Installs a real Python 3.10 (deadsnakes), builds the venv from `/usr/bin/python3.10`, installs torch 2.4.1, the repo, PyG, both CUDA extensions, DA3 and nvdiffrast, then **verifies by import**. Everything in one container. | |
| | `ctrl_guided.py` | **The control.** Waits for the stack to be ready, then runs `guided=default` on Surflo's own real photos (`Surflo/media/sample/`). Run this *before* judging anything. | |
| | `modal_surflo_slim.py` | The main Modal module (kept under ~15 KB — see pitfall 9). Functions: `setup`, `probe`, `fetch_weights`, `infer`, `shrink`, plus local entrypoints. | |
| | `mksheet.py` | In-container PLY → JPEG contact-sheet shrinker. Reads a PLY, validates `declared * stride == body_bytes`, writes `small.ply` + `sheet.jpg` + `STATS.txt`. Needed because artifact transfer is ~1 KB/s. | |
| | `render_anime_views.py` | The Blender orbit renderer that produced the 32 input views. Drives the **live Blender GUI** over the blend-ai socket (`127.0.0.1:9876`), not headless. | |
|
|
| ## Order to run things |
|
|
| ```bash |
| # 1. environment (one container, one function) — this is the long one |
| python -m modal run --detach code/build310.py |
| |
| # 2. THE CONTROL — never skip, never substitute |
| python -m modal run --detach code/ctrl_guided.py |
| |
| # 3. your own data |
| python -m modal run code/modal_surflo_slim.py::infer_anime \ |
| --mode guided --preset default --n-images 32 --points 100000 --tag myrun |
| ``` |
|
|
| ## Notes on the scripts |
|
|
| - `build310.py` writes its log to `/vol/build310.txt` **after every step**, so if the |
| container dies you can still see how far it got. |
| - `ctrl_guided.py` polls for a working stack before running, so it is safe to launch |
| immediately after `build310.py`. |
| - `modal_surflo_slim.py` is deliberately stripped of comments and docstrings — a |
| `modal run` module must stay under ~15 KB or the mount fails with |
| `StreamTerminatedError('Connection lost')`. |
| - Every script unsets `PYTHONPATH` before running anything. Do not remove that. |
|
|
