<<<<<<< HEAD
# WikiDebate

**Tagline:**
> "Debate anything, powered by facts — not opinions."

Generates AI-powered pro vs con debates on controversial or curious topics using data from Wikipedia, in any language.

---

## 🎯 MVP Features
- User inputs a topic
- Fetch factual content from Wikipedia
- Generate Pro & Con arguments using open-source LLMs (Mistral, Phi-2, Gemma)
- Multilingual debate output (LibreTranslate)
- Optional TTS (Coqui TTS or pyttsx3)
- 100% Open Source AI & APIs

---

## 🛠️ Tech Stack
- **Backend:** Flask
- **AI Models:** phi-2, mistral, or ollama (self-hosted)
- **Wikipedia API:** https://en.wikipedia.org/api/rest_v1/
- **Translation:** LibreTranslate
- **Frontend:** Vanilla JS + HTML (or Streamlit for quick UI)
- **Hosting:** Replit, Railway, or local for demo

---

## 📁 Project Structure
```
wikidebate/
├── app.py
├── ai/
│   └── debate_generator.py
├── utils/
│   ├── wikipedia_fetcher.py
│   └── translator.py
├── templates/
│   └── index.html
├── static/
│   └── style.css
├── requirements.txt
└── README.md
```

---

## 🚀 Getting Started

1. **Clone the repo & setup environment**
    ```bash
    git clone <repo-url>
    cd wikidebate
    python3 -m venv venv
    source venv/bin/activate
    pip install -r requirements.txt
    ```
2. **Run the app**
    ```bash
    flask run
    ```

---

## 🧩 Step-by-Step Plan
1. Setup Project
2. Get Wikipedia Data
3. AI-Powered Debate Generator
4. Translate Output
5. Flask Integration
6. Frontend (Quick Sketch)

---

## 🧪 Bonus Features
- 🗣️ Text-to-Speech for debate in user's language
- 🧠 Let user vote on strongest argument
- 🧭 Random Wikipedia topic generator
- 📚 Source reference links below debate

---

## License
MIT 
=======
---
title: WikiDebate
emoji: 👁
colorFrom: pink
colorTo: purple
sdk: gradio
sdk_version: 5.35.0
app_file: app.py
pinned: false
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
>>>>>>> b2848a989f78d84d4e62e1f2ab47d059f0a229ed