Skip to content

GeroZayas/Activity_Suggestor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎲 Activity Suggester

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.

🌍 Online Version

Check out the online version of this web app here: https://activitysuggestor.up.railway.app/ 🎉✨

🚀 Getting Started

To run this application locally, follow these steps:

🛠️ Prerequisites

Ensure you have Python installed on your system. This project requires Python 3.6 or higher.

📥 Installation

Clone the repository:

git clone https://github.com/gerozayas/bored-api-suggester.git cd bored-api-suggester

Install dependencies:

pip install -r requirements.txt

▶️ Running the Application

Run the application:

uvicorn main:app --reload

By default, the application will start on http://127.0.0.1:8000.

🌐 Usage

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.

🤝 Contributing

Contributions are welcome! Feel free to submit pull requests or open issues if you encounter any problems.

📜 License

This project is licensed under the MIT License.

📧 Contact

Gero Zayas - Full Stack Developer
GitHub
Email: gerozayas@gmail.com