AdamPrzychodni/somali-radios-with-ai-for-food-security

Analyzing Somali radio broadcasts with SST and LLMs to extract food security insights. # 📻 Leveraging Local Radio for Real-Time Food Security Insights: An AI-Powered Approach - Preliminary Phase 🇸🇴 This project, in collaboration with **Zero Hunger Lab**, analyzes Somali radio broadcasts to extract food security insights using **Speech-to-Text (STT)** and **LLMs**. The goal is to assess whether radio stations provide timely and useful information to improve food security indicators. --- ## 🚀 Installation & Setup ### Prerequisites - Python 3.8 or higher - Git - Internet connection for API access ### 1. Clone the Repository ```bash git clone github.com cd somali-radios-with-ai-for-food-security ``` ### 2. Create Virtual Environment (Recommended) ```bash # Create virtual environment python -m venv venv # Activate virtual environment source venv/bin/activate # On Linux/Mac # or venv\Scripts\activate # On Windows ``` ### 3. Install Dependencies ```bash pip install -r requirements.txt ``` python data_collection.py \ --start 2020-01-01 \ --end 2025-09-30 \ --output ../data/02_intermediate/transcripts/mustafaa4a_ASR-Somali \ --gpu-batch-size 16 \ --verbose # For maximum speed (if you have VRAM headroom): python data_collection.py \ --start 2020-01-01 \ --end 2025-09-30 \ --output ../data/02_intermediate/transcripts/mustafaa4a_ASR-Somali \ --gpu-batch-size 16 \ --verbose # If running out of memory, reduce batch size: python data_collection.py \ --start 2020-01-01 \ --end 2025-09-30 \ --output ../data/02_intermediate/transcripts/mustafaa4a_ASR-Somali \ --gpu-batch-size 4 \ --verbose ### 4. Setup Gemini API Key 🔑 The project now supports **Google Gemini API** for enhanced transcription accuracy. Follow these steps: #### 4.1 Create Your API Key 1. **Visit Google AI Studio**: Go to aistudio.google.com 2. **Sign in** with your Google Account 3. **Accept terms**: Accept the Google APIs Terms of Service and Gemini API Additional Terms 4. **Create API key**: Click "Get API …