https://github.com/2000pawan/random-cat-images
https://github.com/2000pawan/random-cat-images
python requests streamlit
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/2000pawan/random-cat-images
- Owner: 2000pawan
- License: mit
- Created: 2025-03-29T19:12:57.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-03-29T19:31:51.000Z (2 months ago)
- Last Synced: 2025-03-29T20:24:33.379Z (2 months ago)
- Topics: python, requests, streamlit
- Language: Python
- Homepage: https://random-cat-image-pawan.streamlit.app/
- Size: 10.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Random Cat Images Gallery
This is a simple **Streamlit** application that fetches and displays random cat images from **The Cat API**. It allows users to filter cats by breed and load more images dynamically.
## Features
- Fetches random cat images from **The Cat API**.
- Displays images in a **grid layout**.
- Provides a **dropdown filter** to select cat breeds.
- Includes a **Load Cats** button to refresh images.
## Installation
### Prerequisites
Ensure you have **Python 3.7+** installed on your system.
### Install Dependencies
```bash
pip install streamlit requests
```
## Usage
1. **Get an API Key** from [The Cat API](https://thecatapi.com/).
2. **Replace** `your-api-key-here` in the `app.py` file with your actual API key.
3. **Run the application:**
```bash
streamlit run app.py
```
4. Open the displayed **local URL** in your browser.
## Project Structure
```
|-- app.py # Main Streamlit app
|-- README.md # Documentation
```
## Future Enhancements
- Add **pagination** for loading more images.
- Include a **favorite/save** feature.
- Improve UI with **better styling**.
## License
This project is licensed under the **MIT License**.
## Author
Developed by **Pawan Yadav**.