DakshinVani: A Local Gemma Agent

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle.

What I Built

DakshinVani (दक्षिण वाणी) translates South Indian restaurant menus into Hindi, Marathi, French, Japanese, and German — without falling into the literal-translation traps that make generic tools turn beloved dishes into nonsense or culinary horror.

Walk into an authentic South Indian tiffin room and run their menu through a generic translation tool. Suddenly, iconic dishes turn into comedy—or worse, culinary horror:

DakshinVani is an open-source, locally hosted 3-Stage Culinary Menu Translator Agent powered by Google Gemma (gemma3:4b) that translates South Indian restaurant menus into Hindi (हिन्दी — Primary), Marathi (मराठी), French (Français), Japanese (日本語), and German (Deutsch).

Who'd pay for this: small family-run tiffin rooms and South Indian restaurants abroad, who need accurate, appetizing multilingual menus for tourists and diaspora diners but can't afford a recurring SaaS translation subscription or risk their recipes being sent to third-party training pipelines.

Demo

Run locally:

\bash
git clone https://github.com/kshitij9896/dakshin_vani_gemma_menu_translator
cd dakshin_vani_gemma_menu_translator
pip install -r requirements.txt
python -m uvicorn server:app --reload --port 8000
\\

Then open http://localhost:8000

Code

https://bitly.cx/n8Yzf

How I Built It

How the 3-Stage Gemma Agent Works

1. Stage 1 — DishDeconstructor (Culinary RAG & Allergen Extraction): Scans dish names and chef notes against a curated South Indian Culinary Knowledge Base (south_indian_culinary_kb.json), flagging regional nouns (Podi, Bath, Kuzhi, Degree, Medu, Rasam, Pesarattu, Veechu), cooking vessels, fermentation times, and hidden allergens (A2 cow ghee, sesame oil, mustard seeds, cashews, urad dal).
2. Stage 2 — CulturalBridgeMapper: Maps textures and techniques to each target language's culinary intuition:
   • Hindi (हिन्दी): Bridges South Indian tempering (thalippu) and Podi/Bath concepts for North/Central Indian diners.
   • Marathi (मराठी): Connects Kuzhi Paniyaram to Appe, Milagu Rasam to digestive Saar, and Bisi Bele Bath to Masale Bhat with Marathi Moggu (kapok buds).
   • French (Français): Uses precise gastronomic parallels (galette dentelle fermentée, beignet salé crousti-moelleux, consommé au tamarin, feuilletage à la volée).
   • Japanese (日本語): Draws intuitive parallels to cast-iron Takoyaki molds for Kuzhi Paniyaram, Ganmodoki textures for Medu Vada, and Ochazuke dining style for Rasam.
   • German (Deutsch): Highlights sourdough-style natural fermentation, Gusseisen-Muldenpfanne baking, and strict allergen clarity.
3. Stage 3 — GemmaMenuCopywriter: Generates print-ready multilingual menu cards with native script titles, sensory descriptions, phonetic pronunciation guides, and a "How to Eat" note.

Why Does Open Innovation Matter?

Small family-run tiffin rooms operate on razor-thin margins. They won't pay $50/month for a recurring SaaS subscription just to translate seasonal specials, and they don't want their secret family spice ratios (Bisi Bele Bath 18-spice masala or Milagai Podi proportions) sent to third-party training pipelines.

By running Google Gemma (gemma3:4b) locally via Ollama:

• Zero Marginal API Cost: Once set up on a restaurant manager's laptop, translating new daily specials into 5 languages costs ₹0 / $0.
• Domain Control Over Generic APIs: Closed translation APIs don't let you inject a deterministic South Indian culinary ontology before decoding. With open-weight Gemma + our local JSON RAG graph, the restaurant owns both the glossary and the tone.
• Offline Reliability: Works entirely offline inside the restaurant kitchen or print shop.

Prize Categories

• Best Use of Gemma: Uses Google's open-weight Gemma model (gemma3:4b / gemma2:9b) as the reasoning and multilingual copywriting engine in a 3-stage agentic pipeline.

My Agent Session

$ python agent/gemma_menu_agent.py --dish "Ghee Roast Podi Masala Dosa" --langs hi,mr,fr,ja,de

Stage 1: Matched Ghee Roast Podi Masala Dosa with allergens [Dairy (A2 Cow Ghee), Sesame (in Podi), Mustard Seeds].
Stage 2: Blocked literal trap: Generic translators render 'Podi' as 'Powder/Dust' ('Clarified Butter Roasted Powder Crepe').
Stage 3: Generated culturally grounded translations:
- Hindi: देसी घी रोस्ट मिलगई पोडी मसाला डोसा
- Marathi: साजूक तूप रोस्ट पोडी (चटणी) मसाला डोसा
- French: Dosa Croustillant au Ghee, Podi Torréfié & Pommes de Terre Épicées
- Japanese: 芳醇ギーと焙煎スパイス「ポディ」のクリスピー・マサラドーサ
- German: Knuspriger Ghee-Roast Dosa mit geröstetem Podi-Gewürz & Kartoffel-Masala

$ python agent/gemma_menu_agent.py --dish "Mysuru Bisi Bele Bath with Kara Boondi" --langs hi,mr,fr,ja,de

Stage 1: Matched Mysuru Bisi Bele Bath with Kara Boondi with allergens [Dairy (Ghee), Tree Nuts (Cashews & Peanuts), Mustard Seeds, Sesame/Coconut].
Stage 2: Blocked literal trap: Generic translators notoriously translate 'Bisi Bele Bath' word-for-word as 'Hot Lentil Bath'.
Stage 3: Generated culturally grounded translations:
- Hindi: मैसूरु बिसी बेले भात (कारा बूंदी और काजू तड़के के साथ) - clarifies 'भात' = cooked spiced rice, not a bath!
- Marathi: म्हैसूर बिसी बेळे भात (खमंग खारा बुंदी आणि साजूक तुपासह)
- French: Bisi Bele Bath de Mysore — Risotto Crémeux de Riz & Lentilles aux 18 Épices (clarifies: non un bain!)
- Japanese: マイソール伝統ビシ・ベレ・バーツ（18種スパイス香る南インド風濃厚豆リゾット）(「Bath」はお風呂ではなく炊き込みご飯料理)
- German: Mysuru Bisi Bele Bath — Cremiges Südindisches Linsen-Reis-Risotto mit 18 Gewürzen (kein Bad!)

$ python agent/gemma_menu_agent.py --dish "Rava Kesari Bath" --notes "Slow-roasted semolina pudding infused with Pampore saffron, ghee-fried cashews, and ripe pineapple" --langs hi,mr,fr,ja,de

Dish: Rava Kesari Bath
Region: South Indian Regional Specialty
Allergens: Mustard Seeds, Dairy (Ghee optional), Cashews (Nuts), Semolina (Gluten)
Translations verified across Hindi, Marathi, French, Japanese, and German with phonetic guides and how-to-eat cultural notes.

$ python -m uvicorn server:app --port 8000

INFO: Uvicorn running on http://127.0.0.1:8000 (FastAPI UI: 8 dishes, 8 trap glossary entries loaded)

Session Link: View interactive agent session on DEV
Recorded with DevRelay in Google Antigravity (Gemini 3.8 Flash)