Sama-ndari/gemini-polyglot-guardian

Gemini Polyglot Guardian is an AI-powered tool that analyzes text across multiple languages to detect misinformation, scams, hate speech, and manipulation, while providing clear explanations and safe guidance using Gemini 3. # 🛡️ Gemini Polyglot Guardian **Multilingual Content Safety Analysis Tool powered by Google Gemini 3 API** --- ## 🎯 What is Polyglot Guardian? The **Gemini Polyglot Guardian** is an AI-powered content safety analysis tool that works with text in **any language** — including low-resource languages like **Kirundi**, **Swahili**, **Yoruba**, and more. ### Key Features | Feature | Description | |---------|-------------| | 🌍 **Language Detection** | Automatically detects 100+ languages including low-resource ones | | 🔄 **Translation** | Translates content to English for analysis | | 🎯 **Classification** | Categorizes content into safety categories | | 📊 **Risk Assessment** | Provides risk levels from None to Critical | | 💡 **Explanations** | Detailed reasoning for each classification | | 🛡️ **Safe Responses** | Suggests appropriate actions | ### Classification Categories - ✅ **Safe** - Benign content with no safety concerns - 📰 **Misinformation** - False or misleading claims, health myths, conspiracy theories - 🚨 **Scam** - Fraud attempts, phishing, financial exploitation - 🚫 **Hate Speech** - Content promoting hatred against groups - 🎭 **Manipulation** - Psychological manipulation, coercion --- ## 📁 Project Structure ``` gemini_polyglot_guardian/ ├── gemini_polyglot_guardian.ipynb # Main notebook (all-in-one) ├── requirements.txt # Python dependencies ├── README.md # This file ├── .env # Your API key (create this) └── .venv/ # Virtual environment ``` --- ## 🚀 Quick Start ### Prerequisites - Python 3.10 or higher - Google Gemini API key (Get one here) ### Installation 1. **Clone or download this project** 2. **Navigate to the project directory** ```bash cd gemini_polyglot_guardian ``` 3. **Create and activate virtual environment** ```bash # Create venv (already done if you downloaded this project) python -m venv .venv # Activate on macOS/Linux source .ven …