WikiDebate / README.md
Mahesh Chowdary
Resolve readme conflict
6c2bb6b

<<<<<<< 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
    git clone <repo-url>
    cd wikidebate
    python3 -m venv venv
    source venv/bin/activate
    pip install -r requirements.txt
    
  2. Run the app
    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