Apppublic

Miss-Jahnavi-2731/Telugu-Dialecto-Quiz

sourceHugging Faceupdated 1y agoView on Hugging Face

0likes

App README

🎮 Dialecto Quiz – Telugu Slang Edition

A fun and educational quiz web app built with Streamlit, designed to test and grow your knowledge of Telugu slang phrases. It also allows users to contribute their own phrases and uses Cohere AI to assist with auto-suggested meanings for new slang.

🚀 Features

—🧠 Randomized Quiz: Get 5 unique Telugu slang questions.
—✍️ User Contributions: Submit your own slang phrases and meanings.
—🤖 AI Integration: Auto-suggest slang meanings using Cohere AI.
—📊 Data Storage: Stores phrases in JSON and logs submissions in CSV.
—🎨 UI: Clean and fun interface with custom gradient design.

📦 Tech Stack

—Python
—Streamlit
—Pandas
—Cohere AI API
—JSON and CSV for data handling

🖥️ Demo

🌐 Try the live app: Live on huggingface spaces

🧠 How AI Integration Works

When users leave the "Meaning (in English)" field empty while contributing a phrase, Cohere AI intelligently generates a suggested English interpretation for that slang.

Example: 🗣️ Slang Phrase: thinnava 💡 Suggested Meaning: Have you eaten?

📁 Folder Structure

├── app.py                     # Main Streamlit app
├── phrases.json              # Slang phrases and quiz data
├── submissions.csv           # User-contributed slang
├── requirements.txt          # Python dependencies
├── README.md                 # Project overview and setup instructions
├── REPORT.md                 # Detailed project report (final)
├── CHANGELOG.md              # Development log of changes
├── CONTRIBUTING.md           # Guidelines for contributors
├── LICENSE                   # Open source license
├── Home\_page.jpg            # UI image used in app

⚙️ Setup Instructions

🔧 1. Clone the Repository

bash

git clone https://code.swecha.org/Miss_Jahnavi04/telugu-dialecto-quiz.git
cd telugu-dialecto-quiz

🐍 2. Create Virtual Environment (Optional but recommended)

bash

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

📦 3. Install Dependencies

bash

pip install -r requirements.txt

🔑 4. Add Cohere API Key

Create a folder named .streamlit and a file inside it called secrets.toml:

bash

mkdir .streamlit
touch .streamlit/secrets.toml

Paste the following into .streamlit/secrets.toml:

toml

[cohere]
api_key = "crHAuAsKyg6Xh4ouqIXScYWSri0y6ucDrsEKYh9k"

📝 You can get a free API key from Cohere.ai

▶️ 5. Run the App

bash

streamlit run app.py

🎥 Demo Video

📹 Coming soon... (Record demo showing AI usage + quiz)

✨ Contributors

—👩‍💻 Jahnavi Guntuboina(Team Leader): Dividing the tasks, Checking deadlines and all.
—Nitish Kumar B: UX & Testing
—Sai Shashank Bejjanki: AI Integration
—Yashwanth Myakala: Deployment & Hugging Face
—Mukesh Chowdary Vinjam: Outreach & Corpus Growth
—🌟 Powered by Cohere

📜 License

This project is under the MIT License.

💬 Have suggestions or slang to add?

Pull requests and contributions are welcome. Let’s grow the Telugu slang corpus together!