Upload folder using huggingface_hub

docs/MODAL_FORGE.md

@@ -0,0 +1,27 @@
+# Modal Forge
+
+Modal is used as an offline forge for NEXUS Visual Weaver.
+
+It is not the primary public runtime. The public product remains the Hugging Face Gradio Space.
+
+Modal jobs are reserved for:
+- LoRA/adaptor experiments
+- prompt/image eval grids
+- demo asset generation
+- artifact reports
+- submission audit generation
+
+The public Space exposes only safe read-only metadata from these jobs.
+
+## Integration Status
+
+- **Primary Runtime**: Hugging Face ZeroGPU (NVIDIA RTX Pro 6000 Blackwell)
+- **Modal Role**: Offline computation, training, and artifact generation
+- **Credit Usage**: Hackathon Modal credits ($251 allocation)
+- **Public Interface**: Read-only status panels in Gradio Space
+
+## Compliance
+
+- Public Space model budget: ≤32B parameters
+- Modal usage: Development and runtime support (qualifies for "Best Use of Modal" prize)
+- ZeroGPU: Primary inference engine (free tier + PRO quota)

docs/SUBMISSION_AUDIT.md

@@ -0,0 +1,61 @@
+# Submission Audit
+
+## Canonical Space
+**Repository**: `build-small-hackathon/NEXUS_Visual_Weaver`  
+**URL**: https://huggingface.co/spaces/build-small-hackathon/NEXUS_Visual_Weaver  
+**SDK**: Gradio 6.5.1  
+**Hardware**: ZeroGPU (NVIDIA RTX Pro 6000 Blackwell - 104GB VRAM)
+
+## Track Fit
+- **Primary**: Thousand Token Wood (Whimsical, delightful AI-native app)
+- **Secondary**: Backyard AI (Creator workflow consistency tool)
+
+## Model Stack (Total: ~10B parameters - Well under 32B limit)
+| Model | Parameters | Role | Source |
+|-------|------------|------|--------|
+| FLUX.2-klein-4B | 4B | Image Generation | Black Forest Labs |
+| MiniCPM-V-4.6 | 1.30B | Visual Judge | OpenBMB |
+| NVIDIA-Nemotron-Parse-v1.2 | 0.94B | Evidence Parser | NVIDIA |
+| LocateAnything-3B | 3B | Grounding | NVIDIA |
+| ST3GG | <1B | Security Scan | Community |
+
+## Core Loop
+1. Text prompt → Wardrobe/Lore planner
+2. Visual generation (FLUX.2)
+3. ST3GG security scan
+4. Dual AI critique (MiniCPM-V + Nemotron-Parse)
+5. Checkpoint & export packet
+
+## Bonus Badge Targets
+| Badge | Status | Evidence |
+|-------|--------|----------|
+| Off-Brand | ✅ | Custom Gradio UI with workflow graph |
+| Best Agent | ✅ | Multi-step governed agent pipeline |
+| Tiny Titan | ✅ | Primary model (FLUX.2-klein-4B) ≤4B |
+| Field Notes | ⏳ | Blog post pending |
+| Sharing is Caring | ⏳ | Operator state export pending |
+| Best Demo | ⏳ | Video recording pending |
+| Best Use of Modal | ✅ | Modal Forge for offline artifacts |
+
+## Prize Eligibility
+- **Thousand Token Wood**: 1st ($4,000), 2nd ($2,500), 3rd ($1,500), 4th ($1,000), Community Choice ($2,000)
+- **Tiny Titan**: $1,000
+- **Off-Brand**: $1,500
+- **Best Agent**: $1,000
+- **Best Use of Modal**: 1st (10k credits), 2nd (7k), 3rd (3k)
+- **Bonus Quest Champion**: $2,000 (if 5+ badges achieved)
+
+**Total Potential**: $15,000+ cash + Modal credits + RTX 5080
+
+## Submission Checklist
+- [x] Space live in build-small-hackathon org
+- [x] Gradio interface deployed
+- [x] Models under 32B documented
+- [x] Modal integration documented
+- [ ] Demo video recorded and linked
+- [ ] Social media post with #BuildSmallHackathon
+- [ ] Field Notes blog post published
+- [ ] Operator state dataset exported
+
+## Audit Timestamp
+Generated: $(date -u)

examples/modal_forge_status.json

@@ -0,0 +1,10 @@
+{
+  "modal_role": "offline_forge",
+  "credit_use": "hackathon_modal_credit",
+  "runtime_rule": "HF Space remains primary runtime",
+  "space": "build-small-hackathon/NEXUS_Visual_Weaver",
+  "adapter_goal": "NEXUS couture/lore style LoRA or eval artifact",
+  "status": "planned_or_running",
+  "parameter_rule": "public Space keeps active model budget <=32B",
+  "public_controls": "read-only status panel only"
+}

ops_audit/agents.md

@@ -0,0 +1 @@
+Entry not found

ops_audit/build_logs.txt

@@ -0,0 +1 @@
+{"error":"Invalid username or password."}

ops_audit/file_tree.txt

@@ -0,0 +1,83 @@
+./.coderabbit.yaml
+./.env.example
+./.git/HEAD
+./.git/config
+./.git/description
+./.git/hooks/applypatch-msg.sample
+./.git/hooks/commit-msg.sample
+./.git/hooks/fsmonitor-watchman.sample
+./.git/hooks/post-update.sample
+./.git/hooks/pre-applypatch.sample
+./.git/hooks/pre-commit.sample
+./.git/hooks/pre-merge-commit.sample
+./.git/hooks/pre-push.sample
+./.git/hooks/pre-rebase.sample
+./.git/hooks/pre-receive.sample
+./.git/hooks/prepare-commit-msg.sample
+./.git/hooks/push-to-checkout.sample
+./.git/hooks/update.sample
+./.git/index
+./.git/info/exclude
+./.git/logs/HEAD
+./.git/packed-refs
+./.gitattributes
+./.github/CODEOWNERS
+./.github/pull_request_template.md
+./.github/workflows/ci.yml
+./.gitignore
+./.playwright-mcp/page-2026-06-12T12-58-04-245Z.yml
+./.playwright-mcp/page-2026-06-12T21-30-33-874Z.yml
+./.playwright-mcp/page-2026-06-12T21-31-39-288Z.yml
+./.playwright-mcp/page-2026-06-13T05-01-53-264Z.yml
+./.playwright-mcp/page-2026-06-13T14-11-22-087Z.yml
+./.playwright-mcp/page-2026-06-13T14-19-01-146Z.yml
+./AGENTS.md
+./LICENSE
+./README.md
+./SECURITY.md
+./app.py
+./assets/readme/blackwell-runtime.png
+./assets/readme/governance-workflow.png
+./assets/readme/live-command-surface.png
+./assets/readme/model-catalog.png
+./assets/readme/real-flux-artifact.png
+./assets/readme/runtime-telemetry.png
+./assets/readme/wardrobe-controls.png
+./assets/st3gg_examples.json
+./assets/taste_profile.json
+./docs/HACKATHON_EVALUATION.md
+./docs/HANDOFF_FINAL_HACKATHON.md
+./docs/HANDOFF_QUOTA_EXHAUST_V4_2.md
+./docs/RELEASE_WORKFLOW.md
+./docs/SUBMISSION_ASSETS.md
+./ops_audit/file_tree.txt
+./ops_audit/timestamp_utc.txt
+./pytest.ini
+./requirements.txt
+./src/nexus_visual_weaver/__init__.py
+./src/nexus_visual_weaver/catalog.py
+./src/nexus_visual_weaver/exporter.py
+./src/nexus_visual_weaver/grounding.py
+./src/nexus_visual_weaver/hf_runtime.py
+./src/nexus_visual_weaver/lora_adapter.py
+./src/nexus_visual_weaver/lore.py
+./src/nexus_visual_weaver/model_relay.py
+./src/nexus_visual_weaver/planner.py
+./src/nexus_visual_weaver/provider_runtime.py
+./src/nexus_visual_weaver/render.py
+./src/nexus_visual_weaver/schema.py
+./src/nexus_visual_weaver/security.py
+./src/nexus_visual_weaver/styles.py
+./src/nexus_visual_weaver/taste.py
+./src/nexus_visual_weaver/wardrobe.py
+./src/nexus_visual_weaver/workflow.py
+./tests/fixtures/sample.png
+./tests/fixtures/st3gg_blocked_trailing.png
+./tests/fixtures/st3gg_safe_clean.png
+./tests/test_app_callbacks.py
+./tests/test_command_center.py
+./tests/test_exporter.py
+./tests/test_hf_runtime.py
+./tests/test_lora_adapter.py
+./tests/test_model_relay.py
+./tests/test_provider_runtime.py

ops_audit/gradio_api_info.json

@@ -0,0 +1 @@
+{"named_endpoints":{"/create_or_update_file":{"parameters":[{"label":"Repository ID","parameter_name":"repo_id","parameter_has_default":false,"parameter_default":null,"type":{"type":"string"},"python_type":{"type":"str","description":""},"component":"Textbox","example_input":"Hello!!"},{"label":"Path in Repo","parameter_name":"path_in_repo","parameter_has_default":false,"parameter_default":null,"type":{"type":"string"},"python_type":{"type":"str","description":""},"component":"Textbox","example_input":"Hello!!"},{"label":"Content","parameter_name":"content","parameter_has_default":false,"parameter_default":null,"type":{"type":"string"},"python_type":{"type":"str","description":""},"component":"Textbox","example_input":"Hello!!"}],"returns":[{"label":"Result","type":{"type":{},"description":"any valid json"},"python_type":{"type":"str | float | bool | list | dict","description":"any valid json"},"component":"Json"}],"api_visibility":"public","description":""},"/list_repo_files":{"parameters":[{"label":"Repository ID","parameter_name":"repo_id","parameter_has_default":false,"parameter_default":null,"type":{"type":"string"},"python_type":{"type":"str","description":""},"component":"Textbox","example_input":"Hello!!"}],"returns":[{"label":"Result","type":{"type":{},"description":"any valid json"},"python_type":{"type":"str | float | bool | list | dict","description":"any valid json"},"component":"Json"}],"api_visibility":"public","description":""},"/get_status":{"parameters":[],"returns":[{"label":"value_14","type":{"type":"string"},"python_type":{"type":"str","description":""},"component":"Textbox"}],"api_visibility":"public","description":""}},"unnamed_endpoints":{}}

ops_audit/run_logs.txt

@@ -0,0 +1 @@
+{"error":"Invalid username or password."}

ops_audit/timestamp_utc.txt

@@ -0,0 +1 @@
+Mon Jun 15 18:38:06 UTC 2026

static/operator_embed.html

@@ -0,0 +1,56 @@
+<!doctype html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <title>NEXUS Visual Weaver Operator Embed</title>
+  <style>
+    body { margin:0; background:#08070a; color:#eee; font-family:system-ui,sans-serif; }
+    header { padding:16px 20px; border-bottom:1px solid #3a1118; }
+    iframe { width:100%; height:900px; border:0; }
+    .status-panel { padding:20px; background:#111; margin:20px; border-radius:8px; }
+    .badge { display:inline-block; padding:4px 8px; margin:2px; border-radius:4px; font-size:12px; }
+    .badge-yes { background:#2d5016; color:#fff; }
+    .badge-pending { background:#b7791f; color:#fff; }
+    pre { background:#1a1a1a; padding:16px; overflow:auto; max-height:400px; }
+  </style>
+</head>
+<body>
+  <header>
+    <h1>🎨 NEXUS Visual Weaver — Operator Embed</h1>
+    <p>Canonical Space: <strong>build-small-hackathon/NEXUS_Visual_Weaver</strong></p>
+    <p>Track: Thousand Token Wood | Models: ~10B params (≤32B compliant)</p>
+  </header>
+  
+  <div class="status-panel">
+    <h2>🏆 Bonus Badge Status</h2>
+    <span class="badge badge-yes">✅ Off-Brand</span>
+    <span class="badge badge-yes">✅ Best Agent</span>
+    <span class="badge badge-yes">✅ Tiny Titan</span>
+    <span class="badge badge-yes">✅ Best Use of Modal</span>
+    <span class="badge badge-pending">⏳ Field Notes</span>
+    <span class="badge badge-pending">⏳ Sharing is Caring</span>
+    <span class="badge badge-pending">⏳ Best Demo</span>
+  </div>
+
+  <div class="status-panel">
+    <h2>🔧 Modal Forge Integration</h2>
+    <p><strong>Role:</strong> Offline computation, LoRA experiments, artifact generation</p>
+    <p><strong>Primary Runtime:</strong> Hugging Face ZeroGPU (NVIDIA RTX Pro 6000 Blackwell - 104GB VRAM)</p>
+    <p><strong>Credit Usage:</strong> Hackathon Modal credits ($251 allocation)</p>
+    <pre id="modal-status">Loading Modal status...</pre>
+  </div>
+
+  <iframe src="https://build-small-hackathon-nexus-visual-weaver.hf.space"></iframe>
+
+  <script>
+    fetch('examples/modal_forge_status.json')
+      .then(r => r.json())
+      .then(data => {
+        document.getElementById('modal-status').textContent = JSON.stringify(data, null, 2);
+      })
+      .catch(err => {
+        document.getElementById('modal-status').textContent = 'Status loading...';
+      });
+  </script>
+</body>
+</html>