README.md

metadata

title: Sahel-Voice-Lab
emoji: 🌍
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.25.0
app_file: app_lab.py
hardware: cpu-basic
pinned: false
license: mit
tags:
  - bambara
  - fula
  - speech-recognition
  - language-learning
  - west-africa
  - low-resource-nlp
  - memory

🌍 Sahel-Voice-Lab — Internal Edition

Phase 1 · The Memory Loop

A self-learning voice assistant for Bambara and Fula. Teach it words — it remembers them forever.

Stack (100% non-Meta)

Component	Model
STT	openai/whisper-large-v3-turbo
LLM	Qwen/Qwen2.5-72B-Instruct (set LLM_MODEL_ID env var to override)
TTS	Waxal — Phase 2
Memory	HF Dataset vocabulary.jsonl

How it works

1. Press Push-to-Talk → speak in Bambara, Fula, French, or English
2. Whisper transcribes your speech
3. Gemma reads the vocabulary it has learned so far, then:
   • Teaching mode: detects "X means Y" → saves the word pair to the Hub
   • Question mode: answers using vocabulary as source of truth
   • Conversation mode: replies naturally
4. The last 5 learned words are always visible

Space secrets required

Key	Value
HF_TOKEN	Your HF write-access token
FEEDBACK_REPO_ID	ous-sow/sahel-agri-feedback
LLM_MODEL_ID	Qwen/Qwen2.5-72B-Instruct (or any HF Serverless-supported model)