Codex commited on
Commit
be8ab4a
Β·
1 Parent(s): 618ade6

Add demo video and sponsor publication links

Browse files
Files changed (4) hide show
  1. .gitattributes +1 -0
  2. README.md +27 -7
  3. docs/article.md +20 -2
  4. 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** | 🐦 | *(link to be added)* |
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** β€” MiniCPM5-1B (story) + VoxCPM2 (voice + cloning)
187
- - **Black Forest Labs** β€” FLUX.2-klein-4B (illustration + line art)
188
- - **Hugging Face Spaces / ZeroGPU** β€” hosting + GPU
189
- - **Gradio 6** β€” the product shell
 
 
 
 
 
 
 
 
 
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 DoodleBook interactive demo](https://app.supademo.com/demo/cmqfkwlro4f4wqmgj218kxnqp?utm_source=link)**
 
 
 
 
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