This project is a simple FastAPI application designed to suggest activities for users who might be feeling bored. It leverages the Bored API (and some other activity lists) to fetch random activity suggestions and displays them on a webpage.
Check out the online version of this web app here: https://activitysuggestor.up.railway.app/ 🎉✨
To run this application locally, follow these steps:
Ensure you have Python installed on your system. This project requires Python 3.6 or higher.
Clone the repository:
git clone https://github.com/gerozayas/bored-api-suggester.git cd bored-api-suggester
Install dependencies:
pip install -r requirements.txt
Run the application:
uvicorn main:app --reload
By default, the application will start on http://127.0.0.1:8000
.
Navigate to http://127.0.0.1:8000
in your web browser to view the application. The homepage will display a randomly selected activity suggestion fetched from the Bored API.
Contributions are welcome! Feel free to submit pull requests or open issues if you encounter any problems.
This project is licensed under the MIT License.
Gero Zayas - Full Stack Developer
GitHub
Email: gerozayas@gmail.com