NEXUS_Visual_Weaver / README.md
specimba's picture
Update README.md
c0a34bf verified
|
Raw
History Blame
3.75 kB
---
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 '
---
```markdown
---
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
---
![lastss01](https://cdn-uploads.huggingface.co/production/uploads/69b222a20b5d613944b5ebd3/YrPHu17a-b4f5Qya0Z7bU.png)
# 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)
https://cdn-uploads.huggingface.co/production/uploads/69b222a20b5d613944b5ebd3/P3My9Ol_AeuaueDFhEHOA.mp4
https://dl.dropboxusercontent.com/scl/fi/nb5de0v426z8huni3d11q/chrome_UBiW1QiB9J.mp4?rlkey=m6jawnpairliz7ysfrqet1d59&dl=0
---
## 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.
![lastss02](https://cdn-uploads.huggingface.co/production/uploads/69b222a20b5d613944b5ebd3/YaFbWNddqy4qM9PSluDKY.png)
## 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]
```
![lastss03](https://cdn-uploads.huggingface.co/production/uploads/69b222a20b5d613944b5ebd3/zSmSrb3GQM8lwurcOLWV3.png)
## 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.
![lastss04](https://cdn-uploads.huggingface.co/production/uploads/69b222a20b5d613944b5ebd3/WftSoSAXXkXlkybpj3fNr.png)
## Current Scope
- **Active**: Governed image creation, wardrobe control, ST3GG scanning, human checkpoint, auditable export
- **Gated**: Video generation and external judges (behind review)
![lastss07](https://cdn-uploads.huggingface.co/production/uploads/69b222a20b5d613944b5ebd3/g30Xu3j-ha07ro0Udclxt.png)
## Verification
```bash
python -m compileall app.py
python -m pytest -q tests
```
Latest: **288 tests passing**, clean secret scan.
![lastss05](https://cdn-uploads.huggingface.co/production/uploads/69b222a20b5d613944b5ebd3/6ukBtWdX-KkJBhEI1pc3V.png)
## Local Run
```bash
pip install -r requirements.txt
python app.py
```
![lastss06](https://cdn-uploads.huggingface.co/production/uploads/69b222a20b5d613944b5ebd3/gYW3MrhlWH7JRoJ5NKX-G.png)
## License
Apache-2.0
```