README.md

---
title: Sahel-Voice-Lab
emoji: 🌍
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: "5.25.0"
app_file: app.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) |