README.md

metadata

license: apache-2.0
title: NEXUS_Visual_Weaver
sdk: gradio
emoji: 😻
colorFrom: purple
colorTo: red
pinned: true
thumbnail: >-
  https://cdn-uploads.huggingface.co/production/uploads/69b222a20b5d613944b5ebd3/gsI0HUD1_zeJ1GHbWkLRg.jpeg
short_description: 'best image creation '

---
title: NEXUS Visual Weaver
emoji: 🧵
colorFrom: red
colorTo: gray
sdk: gradio
sdk_version: "5.0"
app_file: app.py
pinned: false
license: apache-2.0
short_description: Governed gothic couture visual creation command center
tags:
  - gradio
  - mcp-server
  - build-small
  - visual-creation
  - hackathon
---

# NEXUS Visual Weaver

**Raven Chronicle** — A governed high-fashion visual creation command center.

> Real generation. Visible governance. Auditable output.

**Live Space:** [build-small-hackathon/NEXUS_Visual_Weaver](https://huggingface.co/spaces/build-small-hackathon/NEXUS_Visual_Weaver)

---

## Live Command Surface

The first screen is the working surface. Creative direction, wardrobe controls, reference metadata, ST3GG scanning, and human checkpoint actions stay together in one governed flow.

## Real Evidence

| Evidence                    | Status          |
|----------------------------|-----------------|
| Real FLUX.2 Klein 9B       | Verified        |
| Creator + Wardrobe controls| Persisted       |
| ST3GG defensive scan       | Active          |
| Human checkpoint           | Required        |
| Export gate                | Blocks until review |
| Tests                      | 288 passing     |
| Runtime                    | ZeroGPU         |

**Generation is not export.** Every artifact must pass ST3GG review + human checkpoint before release.

## How a Governed Weave Works

```mermaid
flowchart LR
    A[Creator Controls] --> B[Prompt Refinement]
    B --> C[FLUX.2 Klein 9B]
    C --> D[ST3GG Scan]
    D --> E{Human Checkpoint}
    E -->|Approved| F[Governed Export]
    E -->|Override| G[Audit Packet]

Governance Model

Every weave carries its own evidence:

• Creator controls & wardrobe slots
• Model route + LoRA status
• Reference metadata + hashes
• ST3GG verdict
• Checkpoint state
• Export decision + override reason

Adult Mode is opt-in and partitioned. It never disables safety or export gates.

Current Scope

• Active: Governed image creation, wardrobe control, ST3GG scanning, human checkpoint, auditable export
• Gated: Video generation and external judges (behind review)

Verification

python -m compileall app.py
python -m pytest -q tests

Latest: 288 tests passing, clean secret scan.

Local Run

pip install -r requirements.txt
python app.py

License

Apache-2.0

---

### What to do now (last minutes):

1. Go to your Space:  
   https://huggingface.co/spaces/build-small-hackathon/NEXUS_Visual_Weaver

2. Click **Files** → `README.md` → **Edit**

3. **Delete everything** and paste the content above.

4. Commit the change.

This should fix the **"Missing configuration in README"** error immediately.

---

Want me to also give you a shorter, even cleaner version, or fix anything else in these last minutes?