File size: 4,009 Bytes
043ea03
 
 
 
 
 
f596da3
 
 
 
043ea03
 
 
 
e28a9bc
043ea03
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
e28a9bc
 
 
 
043ea03
 
 
 
 
 
 
f596da3
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
043ea03
 
 
 
 
 
 
 
 
 
f596da3
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
# Build Small Submission Plan

## Project

- Space: https://huggingface.co/spaces/build-small-hackathon/tiny-dispatch-coach
- Runtime: https://build-small-hackathon-tiny-dispatch-coach.hf.space/
- Submission collection: https://huggingface.co/collections/build-small-hackathon/tiny-dispatch-coach-build-small-submission-6a2a78cece4ba47b80282176
- Real demo video: https://huggingface.co/datasets/build-small-hackathon/tiny-dispatch-coach-media/blob/main/tiny-dispatch-coach-real-demo.webm
- Public sharing post: https://huggingface.co/spaces/build-small-hackathon/tiny-dispatch-coach/discussions/1
- Trace dataset: https://huggingface.co/datasets/build-small-hackathon/tiny-dispatch-coach-traces
- Track: Backyard AI
- Model: `openbmb/MiniCPM5-1B-GGUF`
- File: `MiniCPM5-1B-Q4_K_M.gguf`
- Parameters: 1.08B
- Runtime path: local GGUF through `llama-cpp-python`, enabled by checkbox

## Why It Fits Build Small

Tiny Dispatch Coach solves a narrow operational problem: turn a small delivery
sheet and messy dispatcher notes into an auditable route plan. The model does
not invent routes. MiniCPM5 parses human instructions into a compact constraint
schema, then deterministic code computes time windows, capacity, route splits,
late minutes, waiting time, and baseline deltas.

This makes the small model useful because the task is bounded:

- Extract route constraints from natural language notes.
- Keep all route math deterministic and inspectable.
- Run without cloud LLM APIs.
- Use only synthetic demo data.

## Bonus Quest Alignment

- OpenBMB Awards: uses `openbmb/MiniCPM5-1B-GGUF`.
- Off the Grid: no cloud LLM API or external inference service.
- Llama Champion: MiniCPM5 runs through `llama-cpp-python` when available.
- Field Notes: see `FIELD_NOTES.md`.
- Sharing is Caring: see `agent_trace.json`.

## Demo Video Script

1. Open the Space and point to the OpenBMB MiniCPM5 badges.
2. Leave the CSV empty so the synthetic sample is used.
3. Read the default dispatcher note: start time, urgent school/clinic stops,
   fresh produce before lunch, van capacity 18.
4. Click **Plan route**.
5. Show the parser trace: MiniCPM5 path or explicit deterministic fallback.
6. Show the Dispatch Score:
   - Manual late minutes: 207.
   - Tiny Dispatch Coach late minutes: 0.
   - On-time rate: 100%.
   - Capacity split: 3 trips.
7. Show the driver cards and route map.
8. Close with the privacy stance: synthetic data, no API keys, no customer data,
   no cloud LLM API.

## Social Post Draft

I built Tiny Dispatch Coach for the Build Small Hackathon:

Small delivery teams often have messy notes, tight windows, and a van capacity
constraint. This Gradio Space uses a MiniCPM5-ready constraint parser plus a
deterministic planner to create auditable driver routes. The OpenBMB
MiniCPM5-1B-GGUF path runs locally through llama.cpp when enabled; default fast
mode keeps the public CPU Basic demo responsive.

No cloud LLM API. Synthetic demo data only. 1.08B params.

Space: https://huggingface.co/spaces/build-small-hackathon/tiny-dispatch-coach

#BuildSmallHackathon #HuggingFace #Gradio #OpenBMB #MiniCPM

Published share post:

https://huggingface.co/spaces/build-small-hackathon/tiny-dispatch-coach/discussions/1

## Demo Video

Real browser-captured demo:

https://huggingface.co/datasets/build-small-hackathon/tiny-dispatch-coach-media/blob/main/tiny-dispatch-coach-real-demo.webm

## Submission Package

Public Hugging Face Collection:

https://huggingface.co/collections/build-small-hackathon/tiny-dispatch-coach-build-small-submission-6a2a78cece4ba47b80282176

## Final Submission Checklist

- [x] Public Hugging Face Space.
- [x] Gradio app.
- [x] Model under 32B parameters.
- [x] OpenBMB model listed in README metadata.
- [x] Synthetic sample data only.
- [x] No secrets or real customer records.
- [x] Field notes included.
- [x] Agent trace included.
- [x] Record short demo video.
- [x] Publish social post.
- [x] Package Space link, video link, and social post link before the deadline.