OmondiKevin/swahili-survey-tool

An AI-powered tool that converts Swahili audio survey responses into structured English data, mapping each response to the correct survey question. Enables fast, accurate survey analysis across language barriers. # Swahili Survey Tool A comprehensive engine for processing surveys in both English and Swahili, with support for text and audio responses. ## Table of Contents - Overview - Key Features - Components - Installation - Usage - Survey Format - Audio Response Format - Text Response Format - Output Format - Project Architecture - Troubleshooting - Testing - License - Acknowledgments ## Overview The Swahili Survey Engine is a Python-based application that provides end-to-end functionality for creating, translating, and processing surveys in both English and Swahili. It supports multiple question types, text and audio responses, and provides advanced analysis of survey results. ### Key Features - **Bilingual Support**: Full support for both English and Swahili languages - **Translation**: Automatic translation between English and Swahili using Google Cloud Translation API - **Audio Processing**: Transcription of audio responses using OpenAI's Whisper model - **Response Analysis**: Advanced analysis of survey responses, including keyword extraction and theme clustering - **Multiple Question Types**: Support for multiple-choice, yes/no, and open-ended questions - **Comprehensive Pipeline**: End-to-end processing from survey creation to response analysis ## Components The engine consists of several key components: 1. **Translator**: Handles translation between English and Swahili using Google Cloud Translation API 2. **Question Mapper**: Maps survey questions between different formats and structures 3. **Response Parser**: Parses and analyzes survey responses, particularly open-ended responses 4. **ASR (Automatic Speech Recognition)**: Transcribes audio responses using OpenAI's Whisper model 5. **Pipeline**: Orchestrates the flow between all components to provide a complete survey processing pipeline ## Installation ### Prerequisites - Python 3.8 or higher - Google Cloud API key (for translation) - Internet connec …