epigene commited on
Commit
5afcc11
·
verified ·
1 Parent(s): 5229556

Rewrite model card with showcase images and real energy

Browse files
Files changed (1) hide show
  1. README.md +25 -31
README.md CHANGED
@@ -17,59 +17,53 @@ pipeline_tag: text-to-image
17
 
18
  # 4CGT — 四彫画匠 (Shichō Gashō)
19
 
20
- **Master Artisan of Sculpted Art** quality-engineered anime image generation with cross-platform determinism, DoRA anatomical accuracy, and integrated 2D→3D conversion.
21
 
22
- **GitHub**: [teenu/4cgt](https://github.com/teenu/4cgt)
23
- **Website**: [4cgt.com](https://4cgt.com)
 
 
 
 
 
24
 
25
- ## Assets
26
 
27
- This repo contains all assets needed to run 4CGT:
28
 
29
- | File | Size | Required? |
30
- |------|------|-----------|
31
  | `NoobAI-XL-Vpred-v1.0.safetensors` | 6.7 GB | Yes |
32
  | `dora/noobai_vp10_stabilizer_v0.271_fp16.safetensors` | 44 MB | Yes (recommended) |
33
  | `dora/noobai_vp10_stabilizer_v0.280a_fp16.safetensors` | 64 MB | Yes |
34
  | `style/*.csv` | 109 MB | Yes |
35
  | `controlnet/openpose_fp32.safetensors` | 4.7 GB | Optional (pose control) |
36
- | `poses/*.png` | 140 KB | Optional (example poses) |
37
 
38
- ## Quick Start
39
 
40
  ```bash
41
- # 1. Clone the tool
42
- git clone https://github.com/teenu/4cgt.git
43
- cd 4cgt
44
-
45
- # 2. Install PyTorch (pick your GPU)
46
  pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124
47
-
48
- # 3. Install dependencies
49
  pip install -r requirements.txt
50
 
51
- # 4. Download assets from this repo
52
  pip install huggingface-hub
53
  huggingface-cli download epigene/4cgt --local-dir assets
 
 
54
 
55
- # 5. Move assets into place
56
- mv assets/NoobAI-XL-Vpred-v1.0.safetensors .
57
- mv assets/dora/* dora/
58
- mv assets/controlnet/* controlnet/
59
- mv assets/style/* style/
60
- mv assets/poses/* poses/
61
-
62
- # 6. Run
63
  python main.py
64
  ```
65
 
66
- ## Four Pillars
67
 
68
- - **Anatomical Accuracy** DoRA weight-decomposed adapters optimized for v-prediction
69
- - **Prompt Fidelity** Long prompt support up to 600 tokens with A1111-compatible syntax
70
- - **Image Quality** Lossless FP32 VAE, BF16/FP32 only, FP16 rejected by design
71
- - **Deterministic Output** Same seed = identical image hash across macOS, Windows, Linux
 
72
 
73
  ## License
74
 
75
- AGPL-3.0. See [GitHub](https://github.com/teenu/4cgt) for full license.
 
17
 
18
  # 4CGT — 四彫画匠 (Shichō Gashō)
19
 
20
+ Anime image generation that nails anatomy, follows your prompt, and gives you the same pixel-perfect result on any machine. Every time.
21
 
22
+ <p align="center">
23
+ <img src="https://huggingface.co/epigene/4cgt/resolve/main/showcase/showcase_1.png" width="24%" />
24
+ <img src="https://huggingface.co/epigene/4cgt/resolve/main/showcase/showcase_2.png" width="24%" />
25
+ <img src="https://huggingface.co/epigene/4cgt/resolve/main/showcase/showcase_3.png" width="24%" />
26
+ <img src="https://huggingface.co/epigene/4cgt/resolve/main/showcase/showcase_4.png" width="24%" />
27
+ </p>
28
+ <p align="center"><sub>Seed 7777, 4242, 1337, 3939. DoRA v0.271. ~25s each on RTX 5090.</sub></p>
29
 
30
+ **GitHub**: [teenu/4cgt](https://github.com/teenu/4cgt) | **Website**: [4cgt.com](https://4cgt.com) | **Sponsor**: [GitHub Sponsors](https://github.com/sponsors/teenu)
31
 
32
+ ## Assets
33
 
34
+ | File | Size | Required |
35
+ |------|------|----------|
36
  | `NoobAI-XL-Vpred-v1.0.safetensors` | 6.7 GB | Yes |
37
  | `dora/noobai_vp10_stabilizer_v0.271_fp16.safetensors` | 44 MB | Yes (recommended) |
38
  | `dora/noobai_vp10_stabilizer_v0.280a_fp16.safetensors` | 64 MB | Yes |
39
  | `style/*.csv` | 109 MB | Yes |
40
  | `controlnet/openpose_fp32.safetensors` | 4.7 GB | Optional (pose control) |
41
+ | `poses/*.png` | 140 KB | Optional (examples) |
42
 
43
+ ## Quick start
44
 
45
  ```bash
46
+ git clone https://github.com/teenu/4cgt.git && cd 4cgt
 
 
 
 
47
  pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124
 
 
48
  pip install -r requirements.txt
49
 
50
+ # Download everything from this repo
51
  pip install huggingface-hub
52
  huggingface-cli download epigene/4cgt --local-dir assets
53
+ mv assets/NoobAI-XL-Vpred-v1.0.safetensors . && mv assets/dora/* dora/ && mv assets/style/* style/
54
+ rm -rf assets
55
 
 
 
 
 
 
 
 
 
56
  python main.py
57
  ```
58
 
59
+ ## What makes this different
60
 
61
+ - **DoRA anatomical stabilizers** eliminate the melted-face lottery. Characters have correct proportions, every time.
62
+ - **600-token prompts** with A1111 weight syntax. Standard CLIP cuts off at 77. 4CGT doesn't.
63
+ - **Same seed = same hash.** Byte-identical output across macOS, Windows, Linux. Not "similar" — identical.
64
+ - **2D to 3D in <1 second.** Integrated Apple Sharp pipeline. Generate, convert to Gaussian Splat, render flythrough video.
65
+ - **Lossless pipeline.** FP16 is rejected on load. BF16/FP32 only. FP32 VAE always.
66
 
67
  ## License
68
 
69
+ AGPL-3.0. See [GitHub](https://github.com/teenu/4cgt) for details.