🗣️💬😊 የስሜት መመርመሪያ እና AI Chat (በአማርኛ) 😊💬🗣️

እንኳን ወደ የስሜት መመርመሪያ እና AI Chat ፕሮጀክት በደህና መጡ! ይህ መተግበሪያ በካሜራ አማካኝነት የሰዎችን ስሜት ለመለየት እና በአማርኛ ከሰው ሰራሽ የማሰብ ችሎታ (AI) ጋር ለመወያየት የተሰራ ነው።

🎯 የፕሮጀክቱ ዋና አላማ

ይህንን መተግበሪያ የገነባሁበት ዋና ምክንያት የድብርት ወይም የሀዘን ስሜት የሚሰማቸው ሰዎች ስሜታቸውን የሚረዱበትና የሚገልጹበት እንዲሁም ከሰው ሰራሽ የማሰብ ችሎታ (AI) ጋር በመወያየት የተወሰነ መጽናኛና ድጋፍ እንዲያገኙ ለመርዳት ነው። ❤️🤝 በአስቸጋሪ ጊዜያት ውስጥ ያሉ ሰዎች ሀሳባቸውን የሚካፈሉት ሰው ሲያጡ፣ ይህ AI እንደ አንድ አዛኝ ወዳጅ ሆኖ ሊያገለግላቸው ይችላል። ስሜታቸውን በመለየትም፣ AI የተሻለና ሁኔታውን ያገናዘበ ምላሽ እንዲሰጥ ታስቦ የተሰራ ነው።

✨ ቁልፍ ገጽታዎች

• የቀጥታ የስሜት መለየት: 📸 የኮምፒውተርዎን ካሜራ በመጠቀም እንደ ደስታ፣ ሀዘን፣ ንዴት፣ ፍርሃት፣ መገረም እና ገለልተኛነት ያሉ ስሜቶችን በእውነተኛ ጊዜ ይለያል። (በ Roboflow ሞዴል)
• በአማርኛ የሚወያይ AI: 🗣️ ከ Google Gemini AI ጋር በአማርኛ መወያየት ይችላሉ። AI የተጠቃሚውን ስሜት ከግምት በማስገባት ምላሽ ለመስጠት ይሞክራል።
• ለተጠቃሚ ምቹ ገጽታ: 🧑‍💻 በ Streamlit አማካኝነት የተሰራ ቀላልና ለአጠቃቀም ምቹ የሆነ በይነገጽ አለው።
• ስሜትን መሰረት ያደረገ ውይይት: 😢 ተጠቃሚው የሀዘን ስሜት ካሳየ AI በራሱ ተነሳሽነት ውይይት ሊጀምር ይችላል።
• በአማርኛ የተዘጋጀ: 🇪🇹 ሁሉም መመሪያዎችና መልዕክቶች በአማርኛ ቀርበዋል።

⚙️ የሚያስፈልጉ ነገሮች

• Python (3.8+ ይመከራል)
• የኮምፒውተር ካሜራ
• የበይነመረብ ግንኙነት (ለ API አገልግሎቶች)

🔧 አዘገጃጀት (Installation)

1. ፕሮጀክቱን ኮፒ ያድርጉ (Clone the repository):

   git clone <የፕሮጀክቱ_ማከማቻ_አድራሻ>
   cd <የፕሮጀክቱ_ስም>

2. ቨርቹዋል ኢንቫይሮመንት (Virtual Environment) ይፍጠሩና ያግብሩ (የሚመከር):

   python -m venv venv
   # በ Windows ላይ:
   venv\Scripts\activate
   # በ MacOS/Linux ላይ:
   source venv/bin/activate

3. የሚያስፈልጉ ፓኬጆችን ይጫኑ (Install dependencies): የሚከተሉትን ፓኬጆች የያዘ requirements.txt ፋይል ይፍጠሩ፦

   streamlit
   opencv-python
   numpy
   google-generativeai
   inference-sdk
   

   ከዚያም ይጫኑ፦

   pip install -r requirements.txt

4. የ Haar Cascade ፋይል መኖሩን ያረጋግጡ: ኮዱ cv2.data.haarcascades + 'haarcascade_frontalface_default.xml' የሚለውን ይጠቀማል። opencv-python ሲጫን ይህ ፋይል አብሮ መካተት አለበት። ካልተካተተ ወይም ሌላ ቦታ ላይ ከሆነ መንገዱን በኮዱ ውስጥ ማስተካከል ያስፈልጋል።

🔑 የኤፒአይ ቁልፎች (API Keys)

ይህ መተግበሪያ በትክክል እንዲሰራ የሚከተሉት የኤፒአይ ቁልፎች ያስፈልጉታል፦

• Google Gemini API Key: ለ AI የውይይት ተግባር።
• Roboflow API Key: ለስሜት መለየት ሞዴል።
• Roboflow Model ID: የእርስዎ የ Roboflow ፕሮጀክት ሞዴል መለያ (ለምሳሌ: your-project/1)።
• Roboflow API URL: (አብዛኛው ጊዜ https://detect.roboflow.com ነው)

እነዚህን ቁልፎች በ Streamlit Secrets ውስጥ ማስቀመጥ ያስፈልጋል። በፕሮጀክትዎ ዋና ዳይሬክቶሪ ውስጥ .streamlit የሚባል ፎልደር ይፍጠሩና በውስጡ secrets.toml የሚባል ፋይል ይፍጠሩ። የፋይሉ ይዘት እንዲህ መምሰል አለበት፦

GEMINI_API_KEY = "የእርስዎ_GEMINI_API_KEY_እዚህ_ያስገቡ"
ROBOFLOW_API_KEY = "የእርስዎ_ROBOFLOW_API_KEY_እዚህ_ያስገቡ"
ROBOFLOW_MODEL_ID = "የእርስዎ_ROBOFLOW_MODEL_ID_እዚህ_ያስገቡ" # ምሳሌ: "emotion-detection-model/3"
ROBOFLOW_API_URL = "https://detect.roboflow.com"

ማሳሰቢያ: "የእርስዎ_..." የሚሉትን ቦታዎች በራስዎ ትክክለኛ ቁልፎች ይተኩ።

▶️ መተግበሪያውን ማስኬድ (Running the Application)

ሁሉም ዝግጅቶች ከተጠናቀቁ በኋላ መተግበሪያውን ለማስኬድ፦

streamlit run main.py

🚀 አጠቃቀም

መተግበሪያው ሲከፈት ስምዎን እንዲያስገቡ ይጠይቅዎታል። ስምዎን ያስገቡና "አስገባ / Submit" የሚለውን ይጫኑ።

በግራ በኩል ባለው የመቆጣጠሪያ ክፍል ውስጥ "📷 ካሜራ አብራ/አጥፋ" የሚለውን ቁልፍ በመጫን ካሜራዎን ያብሩ።

ካሜራው ሲበራ መተግበሪያው ፊትዎን ለመለየት ይሞክራል እና ከተሳካ ስሜትዎን ያሳያል።

በቀኝ በኩል ባለው የ AI Chat ክፍል ውስጥ ከ AI ጋር በአማርኛ መወያየት ይችላሉ። መልዕክትዎን ያስገቡና "ላክ" የሚለውን ይጫኑ።

ካሜራው የበራ ከሆነና የሀዘን ስሜት ከታየ AI በራሱ ውይይት ሊጀምር ይችላል።

📜 ማሳሰቢያ

የስሜት መለየቱ ትክክለኛነት በካሜራው ጥራት፣ በብርሃን ሁኔታ እና በ Roboflow ሞዴልዎ አቅም ላይ የተመሰረተ ነው።

ይህ መተግበሪያ ለሙያዊ የህክምና ወይም የስነ-ልቦና ምክር ምትክ አይደለም። ከባድ የስሜት ችግር ካለብዎ እባክዎ ባለሙያ ያማክሩ።

ይህን ፕሮጀክት ስለተመለከቱ እናመሰግናለን! ማንኛውም አስተያየት ወይም ጥያቄ ካለዎት ለማሳወቅ አያመንቱ።