# ZCODES

- **Event:** [Meta Global AI Developer Hackathon](https://cerebralvalley.ai/e/meta-ai-developer-hackathon)
- **When:** Oct 26, 12:00 PM – Nov 4, 9:00 PM (EST)
- **Where:** Online
- **Team:** [Zion Success](https://cerebralvalley.ai/u/zcodes)
- **GitHub:** https://github.com/Zeeohn/kudilens
- **Demo video:** https://www.youtube.com/watch?v=wDFzrHheEfI
- **Gallery:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery
- **Page:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/619

KudiLens turns a market trader's exercise book into verified records a lender can check.

Nigeria has 39.7 million micro, small and medium businesses (NBS/SMEDAN), 96.9% of them micro. Most keep their books in an exercise book or in their head. To a bank, a trader with no records has no income, so they can't borrow, however good their business is.

KudiLens is a bookkeeping agent on Telegram (WhatsApp works too, on Meta's invite-only test number for now). The trader:

- snaps a photo of a page of their sales book, or
- sends a voice note in English, Pidgin, Yorùbá, Hausa or Igbo ("Ahmed buy one bag of rice, 20k, he go pay next week"), or
- snaps the shop wall to count stock.

The design rule is "the models propose, the code verifies". Meta's models read the handwriting, listen to the voice note and count the goods. Then deterministic code adds every line, checks quantity × price, compares the page with the trader's own handwritten total (it finds a single misread digit, or says the written total looks wrong), and flags debts, duplicates and dates. Nothing is saved until the trader taps ✅.

Confirmed entries go into a double-entry ledger kept in integer kobo, and each one is sealed into a SHA-256 hash chain together with the fingerprint of the photo or voice note it came from. The trader shares one link, the Kudi Passport: 30/90-day sales, credit collected, how many records are backed by a photo or voice note, and no customer names. The lender presses Verify, the chain is recomputed live, and if anyone changed a single naira, it shows exactly which record.

The trader can also ask "who owes me pass?" (an agent with read-only tools answers from the ledger and drafts a polite reminder to forward), get a daily or weekly summary, and turn today's stock into a WhatsApp status flyer.

Field-tested in Lagos shops on a trader's own phone: 36/36 lines read exactly on 4 real page photos, wrong written totals caught, voice-note entries saved without edits (eval/FIELD-TEST.md). Open source (Apache-2.0), 42 tests, zero npm dependencies, live now at t.me/KudiLensBot.

## More from Meta Global AI Developer Hackathon

- [KINETICA](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/616)
- [Alien on Earth](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/617)
- [HuxTek](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/618)
- [Mihail Tsvetanov](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/620)
- [Benjamin Kincses](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/621)
- [KoreaLens](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/622)

---

Markdown version of https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/619. Site index for agents: https://cerebralvalley.ai/llms.txt · full text: https://cerebralvalley.ai/llms-full.txt