An open API service indexing awesome lists of open source software.

https://github.com/krishbharadwaj5678/riddleriot

Experience the excitement of solving riddles and brain teasers. Join the riot of fun and test your problem-solving skills.
https://github.com/krishbharadwaj5678/riddleriot

api api-integration brain-teaser brain-teasers deployment fun interactive logic-puzzles problem-solving puzzle-game puzzles python python3 riddle riddle-game riddles streamlit trivia web-app

Last synced: about 1 month ago
JSON representation

Experience the excitement of solving riddles and brain teasers. Join the riot of fun and test your problem-solving skills.

Awesome Lists containing this project

README

          

# 🧠 RiddleRiot

RiddleRiot is a Python based webpage that challenges users with a wide variety of random riddle. Perfect for curious minds of all ages, it turns critical thinking into an entertaining adventure.

![RiddleRiot](https://github.com/KrishBharadwaj5678/RiddleRiot/raw/main/RiddleRiot.png)

## 🚀 Features

| 🧩 Feature | 📄 Description |
|------------------------|-----------------------------------------------|
| 🔘 Riddle Generator | Generates a random riddle |
| 🌐 API Integration | Fetches riddles from API Ninjas |
| 🧠 Title & Question | Displays riddle title and question |
| 👁️ Reveal Answer | Click to show the riddle answer |
| 📱 Responsive UI | Works on desktop and mobile devices |

---

## 🛠️ Tech Stack

| 🔧 Technology | 📄 Description |
|------------------------|---------------------------------------------------- |
| 🐍 Python | Core programming language used to build the app |
| 🚀 Streamlit | Framework for creating interactive web interfaces |
| ⚙️ APIs | APIs for riddle management and logic |
| ☁️ Streamlit Cloud | Hosting platform to deploy and share the app |

---

## 📦 Installation

Clone the repository:

```bash
git clone https://github.com/KrishBharadwaj5678/RiddleRiot.git
cd RiddleRiot
````

Install dependencies:

```bash
pip install -r requirements.txt
```

Start the development server:

```bash
streamlit run app.py
```

---

## 🤝 Contributing

Contributions are welcome! 🎉

1. 🍴 Fork the repo
2. 🌿 Create your feature branch: `git checkout -b my-new-feature`
3. 💾 Commit your changes: `git commit -m 'Add some feature'`
4. 📤 Push to the branch: `git push origin my-new-feature`
5. 🔃 Open a pull request