Codex commited on
Commit Β·
be8ab4a
1
Parent(s): 618ade6
Add demo video and sponsor publication links
Browse files- .gitattributes +1 -0
- README.md +27 -7
- docs/article.md +20 -2
- docs/demo-doodlebook.mp4 +3 -0
.gitattributes
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
*.mp4 filter=lfs diff=lfs merge=lfs -text
|
README.md
CHANGED
|
@@ -42,8 +42,8 @@ Built for the **Build Small Hackathon 2026 Β· Adventure in Thousand Token Wood**
|
|
| 42 |
|---|---|---|
|
| 43 |
| **Stay under 32B** | β
| MiniCPM5-1B (1B) + VoxCPM2 (2B) + FLUX.2-klein-4B (4B) = **7B total** |
|
| 44 |
| **Ship a Gradio app** | β
| Gradio 6 Space in the Build Small org |
|
| 45 |
-
| **Record a demo** | β
| [Supademo walkthrough](https://app.supademo.com/demo/cmqfkwlro4f4wqmgj218kxnqp?utm_source=link) |
|
| 46 |
-
| **Post on social media** |
|
| 47 |
| **GPU limit (β€10 ZeroGPU)** | β
| 1 ZeroGPU Space |
|
| 48 |
|
| 49 |
---
|
|
@@ -53,7 +53,8 @@ Built for the **Build Small Hackathon 2026 Β· Adventure in Thousand Token Wood**
|
|
| 53 |
| | |
|
| 54 |
|---|---|
|
| 55 |
| π **Live Space** | [huggingface.co/spaces/build-small-hackathon/DoodleBook](https://huggingface.co/spaces/build-small-hackathon/DoodleBook) |
|
| 56 |
-
| βΆοΈ **Demo video** | [Supademo walkthrough](https://app.supademo.com/demo/cmqfkwlro4f4wqmgj218kxnqp?utm_source=link) |
|
|
|
|
| 57 |
| π **Project article** (complete technical paper) | [docs/article.md](docs/article.md) |
|
| 58 |
| π¬ **Field Notes** (technical deep-dive) | [docs/blog.md](docs/blog.md) |
|
| 59 |
| π» **Source code** | [github.com/Sushruths04/Doodle-book](https://github.com/Sushruths04/Doodle-book) |
|
|
@@ -170,6 +171,16 @@ Open **"Behind the magic β Trace"** on any generated book:
|
|
| 170 |
|
| 171 |
---
|
| 172 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 173 |
## βΆοΈ Run locally
|
| 174 |
|
| 175 |
```bash
|
|
@@ -183,10 +194,19 @@ The example doodle (`assets/sample_doodle.jpg`) and the instant sample book are
|
|
| 183 |
|
| 184 |
## π€ Sponsor & tool stack
|
| 185 |
|
| 186 |
-
- **OpenBMB** β
|
| 187 |
-
|
| 188 |
-
|
| 189 |
-
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 190 |
|
| 191 |
---
|
| 192 |
|
|
|
|
| 42 |
|---|---|---|
|
| 43 |
| **Stay under 32B** | β
| MiniCPM5-1B (1B) + VoxCPM2 (2B) + FLUX.2-klein-4B (4B) = **7B total** |
|
| 44 |
| **Ship a Gradio app** | β
| Gradio 6 Space in the Build Small org |
|
| 45 |
+
| **Record a demo** | β
| [MP4 demo](docs/demo-doodlebook.mp4) + [Supademo walkthrough](https://app.supademo.com/demo/cmqfkwlro4f4wqmgj218kxnqp?utm_source=link) |
|
| 46 |
+
| **Post on social media** | β
| [X/Twitter post](https://x.com/sushruthsgowda/status/2066639063168225452?s=46) |
|
| 47 |
| **GPU limit (β€10 ZeroGPU)** | β
| 1 ZeroGPU Space |
|
| 48 |
|
| 49 |
---
|
|
|
|
| 53 |
| | |
|
| 54 |
|---|---|
|
| 55 |
| π **Live Space** | [huggingface.co/spaces/build-small-hackathon/DoodleBook](https://huggingface.co/spaces/build-small-hackathon/DoodleBook) |
|
| 56 |
+
| βΆοΈ **Demo video** | [MP4 demo](docs/demo-doodlebook.mp4) Β· [Supademo walkthrough](https://app.supademo.com/demo/cmqfkwlro4f4wqmgj218kxnqp?utm_source=link) |
|
| 57 |
+
| π£ **Social post** | [X/Twitter announcement](https://x.com/sushruthsgowda/status/2066639063168225452?s=46) |
|
| 58 |
| π **Project article** (complete technical paper) | [docs/article.md](docs/article.md) |
|
| 59 |
| π¬ **Field Notes** (technical deep-dive) | [docs/blog.md](docs/blog.md) |
|
| 60 |
| π» **Source code** | [github.com/Sushruths04/Doodle-book](https://github.com/Sushruths04/Doodle-book) |
|
|
|
|
| 171 |
|
| 172 |
---
|
| 173 |
|
| 174 |
+
## π€ Built with Codex
|
| 175 |
+
|
| 176 |
+
Codex was used throughout the build as the engineering agent for implementation, debugging,
|
| 177 |
+
prompt refinement, documentation, README updates, deployment commits, and Hugging Face Space
|
| 178 |
+
publishing. The final repository history credits Codex-authored implementation commits where
|
| 179 |
+
Codex performed the coding work, including the latest prompt, article, README, and deployment
|
| 180 |
+
updates.
|
| 181 |
+
|
| 182 |
+
---
|
| 183 |
+
|
| 184 |
## βΆοΈ Run locally
|
| 185 |
|
| 186 |
```bash
|
|
|
|
| 194 |
|
| 195 |
## π€ Sponsor & tool stack
|
| 196 |
|
| 197 |
+
- **OpenBMB** β powers the 3B reasoning-and-voice core. `MiniCPM5-1B` writes the structured
|
| 198 |
+
story JSON, title, character description, page text, and visual scene plan. `VoxCPM2`
|
| 199 |
+
narrates the book, supports expressive narrator presets, and enables the My Voice option
|
| 200 |
+
through zero-shot voice cloning from an uploaded reference clip.
|
| 201 |
+
- **Black Forest Labs** β powers all visual generation through `FLUX.2-klein-4B`. It creates
|
| 202 |
+
the canonical hero from the child's doodle, renders all six crayon-style story pages, and
|
| 203 |
+
redraws finished pages into clean coloring-book line art.
|
| 204 |
+
- **Hugging Face Spaces / ZeroGPU** β hosts the public Gradio app and provides the GPU runtime
|
| 205 |
+
that makes the full pipeline publicly accessible without running private infrastructure.
|
| 206 |
+
- **Gradio 6** β provides the app framework; DoodleBook customizes it into a scrapbook-style,
|
| 207 |
+
mobile-friendly product interface instead of a default demo layout.
|
| 208 |
+
- **Codex** β used as the coding and documentation agent for repository changes, prompt
|
| 209 |
+
engineering, debugging, commit preparation, and deployment updates.
|
| 210 |
|
| 211 |
---
|
| 212 |
|
docs/article.md
CHANGED
|
@@ -4,7 +4,9 @@
|
|
| 4 |
|
| 5 |
**Live demo:** [build-small-hackathon/DoodleBook](https://huggingface.co/spaces/build-small-hackathon/DoodleBook)
|
| 6 |
|
| 7 |
-
**Demo video:** [Supademo walkthrough](https://app.supademo.com/demo/cmqfkwlro4f4wqmgj218kxnqp?utm_source=link)
|
|
|
|
|
|
|
| 8 |
|
| 9 |
**Source:** [github.com/Sushruths04/Doodle-book](https://github.com/Sushruths04/Doodle-book)
|
| 10 |
|
|
@@ -409,6 +411,18 @@ provides the zero-shot custom voice feature.
|
|
| 409 |
FLUX.2-klein-4B creates the canonical hero, renders six story pages, and semantically redraws the
|
| 410 |
optional coloring pages.
|
| 411 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 412 |
### Open Trace
|
| 413 |
|
| 414 |
Generation settings, timings, model state, and fallback information are visible in the app.
|
|
@@ -455,7 +469,11 @@ The next technically justified improvements are:
|
|
| 455 |
|
| 456 |
The published demo video is available here:
|
| 457 |
|
| 458 |
-
**[Watch the
|
|
|
|
|
|
|
|
|
|
|
|
|
| 459 |
|
| 460 |
It walks through the complete process:
|
| 461 |
|
|
|
|
| 4 |
|
| 5 |
**Live demo:** [build-small-hackathon/DoodleBook](https://huggingface.co/spaces/build-small-hackathon/DoodleBook)
|
| 6 |
|
| 7 |
+
**Demo video:** [MP4 demo](demo-doodlebook.mp4) and [Supademo walkthrough](https://app.supademo.com/demo/cmqfkwlro4f4wqmgj218kxnqp?utm_source=link)
|
| 8 |
+
|
| 9 |
+
**Social post:** [X/Twitter announcement](https://x.com/sushruthsgowda/status/2066639063168225452?s=46)
|
| 10 |
|
| 11 |
**Source:** [github.com/Sushruths04/Doodle-book](https://github.com/Sushruths04/Doodle-book)
|
| 12 |
|
|
|
|
| 411 |
FLUX.2-klein-4B creates the canonical hero, renders six story pages, and semantically redraws the
|
| 412 |
optional coloring pages.
|
| 413 |
|
| 414 |
+
### Hugging Face
|
| 415 |
+
|
| 416 |
+
Hugging Face Spaces hosts the public demo, ZeroGPU supplies the GPU execution environment, and
|
| 417 |
+
the Hub stores the code, article, demo assets, model metadata, and reproducible commit history.
|
| 418 |
+
|
| 419 |
+
### Codex
|
| 420 |
+
|
| 421 |
+
Codex was used as the coding and documentation agent across the project. It helped implement
|
| 422 |
+
and debug the app, refine prompts, update the story/image/audio generation instructions, prepare
|
| 423 |
+
the technical article, maintain the README, create deployment commits, and publish updates to
|
| 424 |
+
the Hugging Face Space.
|
| 425 |
+
|
| 426 |
### Open Trace
|
| 427 |
|
| 428 |
Generation settings, timings, model state, and fallback information are visible in the app.
|
|
|
|
| 469 |
|
| 470 |
The published demo video is available here:
|
| 471 |
|
| 472 |
+
**[Watch the MP4 demo](demo-doodlebook.mp4)**
|
| 473 |
+
|
| 474 |
+
**[Open the Supademo walkthrough](https://app.supademo.com/demo/cmqfkwlro4f4wqmgj218kxnqp?utm_source=link)**
|
| 475 |
+
|
| 476 |
+
**[View the X/Twitter post](https://x.com/sushruthsgowda/status/2066639063168225452?s=46)**
|
| 477 |
|
| 478 |
It walks through the complete process:
|
| 479 |
|
docs/demo-doodlebook.mp4
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:77d66ff6a9d224aca57f196b43df9d14fdb432441df80b21cfc64fd19e1c85f7
|
| 3 |
+
size 74957890
|