SUBMISSION.md

Trollsona Submission Pack

Submission Checklist

requirement	status	proof	missing action
Public GitHub repo	DONE	https://github.com/rthgit/Trollsona	None
Codex-attributed commits	DONE	3fe2db1, 4f196a6, 8a1b09d	None
Space README links to repo	DONE	README.md contains repo URL	None
Hugging Face Space deploy	DONE	https://huggingface.co/spaces/build-small-hackathon/Trollsona	None
Backup Space deploy	DONE	https://huggingface.co/spaces/RthItalia/Trollsona	None
Space link	DONE	README.md contains https://huggingface.co/spaces/build-small-hackathon/Trollsona	None
Space model variables	DONE	.env.example documents TROLLSONA_ENABLE_MODEL=1, TROLLSONA_MODEL_ID=RthItalia/nano_compact_3b_qkvfp16, TROLLSONA_FALLBACK_MODEL_ID=Qwen/Qwen2.5-0.5B-Instruct	Configure the same variables in Space settings if overriding defaults
Demo video file	DONE	artifacts/trollsona-demo.mp4	None
Demo video public URL	DONE	https://youtu.be/p2m9tac8lF8	None
Social post	DONE	https://www.linkedin.com/posts/christian-quintino-de-luca-72b808344_buildsmall-gradio-huggingface-ugcPost-7468732928114651137-zX2a/	None
Gradio app	DONE	app.py defines gr.Blocks app	None
Small model <=32B	DONE	Primary model id: RthItalia/nano_compact_3b_qkvfp16; fallback model id: Qwen/Qwen2.5-0.5B-Instruct	None
Transformers model path	DONE	TROLLSONA_ENABLE_MODEL=1 in Space variables; AutoModelForCausalLM.from_pretrained(..., trust_remote_code=True) implemented	None
Deterministic fallback	DONE	Fallback remains available with TROLLSONA_ENABLE_MODEL=0, unavailable CUDA, model failure, or invalid model output	None
Debug hidden by default	DONE	Source/fallback live in See the cursed paperwork	None
No mandatory cloud API	DONE	Public HF model path and fallback require no app secrets	None

Demo Video Script

Target length: 45-60 seconds.

Recommended tested input:

Name: Alex
Lore: I start productivity systems and then reorganize the labels forever.
Persona: Dungeon Intern
Spice: 4
Advice: on

Hosted test result on the official Build Small Space: Source: transformers_model; runtime Qwen/Qwen2.5-0.5B-Instruct as CPU fallback model.

timestamp	action	what it shows	suggested line
0:00-0:05	Open the Space	Trollsona hero, badges, dark ritual UI	"This is Trollsona: a small-model goblin that turns your personal lore into a cursed alter ego."
0:05-0:15	Enter name and lore	What do they call you?, Confess your little lore	"I give it a name and a very specific little confession."
0:15-0:23	Pick menace and sting	Dungeon Intern, spice 4, advice on	"Then I choose the resident menace and how hard it should sting."
0:23-0:32	Click Summon Trollsona	End-to-end generation	"It summons a theatrical dossier instead of a plain chatbot answer."
0:32-0:42	Show result card	Trollsona name, roast, useful slap, goblin meter	"You get a name, a roast, one useful slap, and the goblin meter."
0:42-0:50	Open paperwork	Source: transformers_model and CPU runtime	"The model details stay hidden in the cursed paperwork until you ask for them."
0:50-0:58	Show README/Codex Track	Space, GitHub, model cascade, Codex commits	"Built as a Gradio Space with a small-model cascade and Codex-tracked commits."
0:58-1:00	Close on Space	Final result card or Space URL	"Tiny model, giant attitude."

Social Post Draft

Hook: I built a little ritual that summons the troll living behind your respectable personality.

Description: Trollsona turns a short confession into a theatrical alter-ego dossier: trollsona name, playful roast, one useful slap, and a goblin meter.

Tech note: Built for Build Small Hackathon as a Gradio Hugging Face Space. The primary model is RthItalia/nano_compact_3b_qkvfp16, derived from Qwen/Qwen2.5-3B-Instruct and under the <=32B small-model constraint. A Qwen 0.5B model and deterministic fallback remain as reliability guards.

Links:

• Space: https://huggingface.co/spaces/build-small-hackathon/Trollsona
• GitHub: https://github.com/rthgit/Trollsona
• Demo video: https://youtu.be/p2m9tac8lF8

CTA: Try it, summon your menace, and share the dossier.

Release QA

test	command/action	expected result	status
Python compile	python -B -m py_compile app.py	no syntax errors	DONE
Model path implemented	inspect app.py	Space sets TROLLSONA_ENABLE_MODEL=1; from_pretrained(..., trust_remote_code=True) path present	DONE
Deterministic fallback	run generate_trollsona(...) twice	identical structured output	DONE
Local Gradio launch	python app.py	app opens on 127.0.0.1:7860	DONE in local QA
Input-full generation	fill name + lore + summon	result card renders	DONE in local QA
Input-minimal generation	empty name/lore	output still complete	DONE
Debug default	load page	source/fallback hidden	DONE
Visual contrast	inspect input/dropdown/checkbox/CTA/card	readable UI	DONE
Git status	git status --short --ignored	only ignored .env / QA screenshot remain	DONE
README repo link	inspect README	GitHub URL present	DONE
Official org Space build	Hugging Face Space/API check	public app returns HTTP 200	DONE
Browser test on Space	Playwright on public Space	card renders; debug source/fallback hidden until accordion opens	DONE
Hosted model-backed generation	Gradio API on official org Space	Source: transformers_model; result card renders	DONE

Final Ship Plan

step	owner	output	done criteria	priority
1	Codex	Final README and submission docs	Docs committed	P0
2	Codex/User	GitHub push	rthgit/Trollsona contains latest commits	P0
3	Codex	Official Build Small Hugging Face Space	Public Space URL opens app	P0
4	Codex	README Space link	Space URL is present in README.md	P0
5	User	Demo video public upload	Public video URL available	P0
6	User	Social post	Published post with links	DONE
7	User	Submission form	All required URLs submitted	P0