CoolFace
Apppublic

Lioness256/Sunbird_AI_GenAI_application

sourceHugging Faceupdated 4mo agoView on Hugging Face
0likes
App README

๐ŸŒป Sunbird AI Pipeline

A Streamlit web app that takes text or an audio recording, transcribes it, summarises it, translates the summary into an East African language, and reads it back โ€” all powered by Sunbird AI.

Pipeline

Input (text or audio)
  โ””โ”€โ–บ [STT]        /tasks/stt              โ†’ transcript
        โ””โ”€โ–บ [LLM]  /tasks/sunflower_simple โ†’ summary
              โ””โ”€โ–บ [LLM]  /tasks/sunflower_simple โ†’ translation
                    โ””โ”€โ–บ [TTS]  /tasks/tts  โ†’ audio

Local setup

bash
git clone https://github.com/Bahati-bk/internship-assessment.git
cd internship-assessment
python -m venv venv
# Windows:
venv\Scripts\activate
# Mac/Linux:
source venv/bin/activate

pip install -r requirements.txt

Copy .env.example to .env and fill in your token:

bash
cp .env.example .env
# edit .env and set SUNBIRD_API_TOKEN=<your token>

Run the app:

bash
streamlit run app.py

Environment variables

VariableDescription
SUNBIRD_API_TOKENBearer token for the Sunbird AI API. Get one at https://platform.sunbird.ai

Usage

  1. 1.Choose Text or Audio file as input
  2. 2.Pick a target language (Luganda, Runyankole, Ateso, Lugbara, or Acholi)
  3. 3.Click โ–ถ Run Pipeline
  4. 4.Results appear as each step completes โ€” transcript, summary, translation, and a playable audio clip

Known limitations

  • โ€”Audio files are capped at 5 minutes
  • โ€”Supported output languages: Luganda, Runyankole, Ateso, Lugbara, Acholi
  • โ€”TTS quality depends on the Sunbird AI speaker models for each language