Aman-byte1/Amharic-Hate-Speech-Detection-Rephrasing-Application

የአማርኛ የጥላቻ ንግግር መለያ እና የአገላለፅ ማስተካከያ መተግበሪያ ነው። ይህ ፕሮጀክት የማሽን መማሪያ ሞዴሎችን እና የጀሚኒ ኤፒአይን ይጠቀማል። (Amharic hate speech detection and polite rephrasing application. This project uses machine learning models and the Gemini API.) # የአማርኛ የጥላቻ ንግግር መለያ እና የአገላለፅ ማስተካከያ መተግበሪያ 🇪🇹 ይህ መተግበሪያ በአማርኛ የተጻፉ ጽሑፎችን በመተንተን የጥላቻ ንግግር መሆን አለመሆናቸውን ለመለየት የተሰራ ነው። በተጨማሪም፣ አንድ ጽሑፍ የጥላቻ ንግግር ሆኖ ከተገኘ፣ ይበልጥ ጨዋ በሆነ አገላለጽ ለመቀየር የጉግል ጀሚኒ ኤፒአይን ይጠቀማል። ## የፕሮጀክቱ ዓላማ የዚህ ፕሮጀክት ዋና ዋና ዓላማዎች የሚከተሉት ናቸው፦ 1. **የጥላቻ ንግግርን መለየት፦** የተለያዩ የማሽን መማሪያ ሞዴሎችን (Machine Learning Models) በመጠቀም በአማርኛ ጽሑፎች ውስጥ የሚገኙ የጥላቻ ንግግሮችን በራስ-ሰር መለየት። 2. **የአገላለፅ ማሻሻያ፦** የጥላቻ ይዘት ያላቸውን ጽሑፎች ይበልጥ አክብሮት የተሞላበትና ገንቢ ወደሆነ አገላለፅ እንዲቀየሩ ማገዝ። 3. **ግንዛቤ መፍጠር፦** ስለ ጥላቻ ንግግርና ስለሚያስከትለው ጉዳት ግንዛቤ ለመፍጠር እንዲሁም ጤናማ የመስመር ላይ ውይይቶችን ለማበረታታት። 4. **የቴክኖሎጂ አጠቃቀም ማሳያ፦** በአማርኛ ቋንቋ የጽሑፍ ትንተና እና የተፈጥሮ ቋንቋ ማቀነባበሪያ (NLP) ቴክኖሎጂዎችን ተግባራዊ አጠቃቀም ማሳየት። ## ያገለገሉ ቴክኖሎጂዎች * **Python:** ለፕሮግራሚንግ ቋንቋነት * **Streamlit:** ለተጠቃሚ በይነገጽ (User Interface) መፍጠሪያ * **Scikit-learn:** ለባህላዊ የማሽን መማሪያ ሞዴሎች (እንደ Logistic Regression, Naive Bayes, SVM, Decision Tree, Random Forest, Gradient Boosting, KNN, Perceptron) * **Pandas & NumPy:** ለመረጃ አያያዝ እና ስሌት * **Joblib:** የሰለጠኑ ሞዴሎችን ለማስቀመጥ እና ለመጫን * **Google Generative AI (Gemini API):** የጥላቻ ንግግሮችን ወደ ጨዋ አገላለጾች ለመቀየር ## መተግበሪያውን ለማስኬድ የሚያስፈልጉ ነገሮች (Prerequisites) 1. **Python 3.8+** መጫን አለቦት። 2. **PIP** (የፓይዘን ፓኬጅ መጫኛ) መኖር አለበት። 3. **የጀሚኒ ኤፒአይ ቁልፍ (Gemini API Key):** ከጉግል ኤአይ ስቱዲዮ (Google AI Studio) ማግኘት ይችላሉ። (aistudio.google.com) ## የማዋቀር እና የማስኬጃ ሂደት (Setup and Running the Application) 1. **ፕሮጀክቱን ከጊትሀብ (ወይም ካለበት ቦታ) ያውርዱ (Clone/Download):** ```bash git clone Amharic-Hate-Speech-Detection-Rephrasing-Application.git cd Amharic Hate Speech Detection & Rephrasing Application ``` 2. **ምናባዊ አካባቢ (Virtual Environment) ይፍጠሩ (የሚመከር):** ```bash python -m venv myenv source myenv/bin/activate # በሊኑክስ/ማክ ላይ myenv\Scripts\activate # በዊንዶውስ ላይ ``` 3. **የሚያስፈልጉ ፓኬጆችን ይጫኑ:** ```bash pip install -r requirements.txt ``` 4. **የጀሚኒ ኤፒአይ ቁልፍዎን ያዋቅሩ:** * በፕሮጀክቱ ዋና ዳይሬክተሪ ውስጥ `.streamlit` የሚል ፎልደር ይፍጠሩ። * በ`.streamlit` ፎልደር ውስጥ `secrets.toml` የሚል ፋይል ይፍጠሩ። * በ `secrets.toml` ፋይል ውስጥ የሚከተለውን ያስገቡና `YOUR_API …