martabento / bookish-genie

A book recommendation system for book lovers, powered by AI. 🧠 Created with Next.js, React, Zustand, Tailwind & shadcn/ui.

BookishGenie

Discover your next literary adventure with BookishGenie, your trusted AI companion in the world of books. 📚

BookishGenie Desktop Preview

BookishGenie Mobile Preview

Project intro

BookishGenie is a web application that aims to simplify the process of finding your next captivating book to read. With a few simple steps, you can share your reading preferences and let BookishGenie's AI recommendation engine do its magic, providing personalized book recommendations tailored to your taste.

Features

• Step-by-step Wizard: BookishGenie provides a user-friendly step-by-step wizard interface to collect your reading preferences. You'll be guided through selecting your favorite genre, mood, and book length preference.

• AI-powered Recommendations: BookishGenie utilizes the power of artificial intelligence to generate personalized book recommendations based on your preferences. The recommendations are generated using the OpenAI GPT-3.5 Turbo model.

• Book Information: BookishGenie not only provides recommendations but also fetches detailed book information, including book covers and other metadata. It uses the Google Books API to retrieve book information based on the recommendations.

• Persistent Storage: BookishGenie stores your recommendations and book information in the browser's localStorage, allowing you to revisit your recommendations without losing them.

Technologies

• React
• Next.js
• Zustand
• Tailwind CSS
• shadcn/ui
• OpenAI GPT-3.5 Turbo
• Google Books API

Getting Started

Follow the instructions below to get the project up and running on your local machine.

Installation

1. Clone the repository:

git clone https://github.com/MartaBento/bookish-genie.git

2. Navigate to the project directory:

cd bookish-genie

3. Install dependencies:

npm install

4. Set up environment variables:
   • Create a new file named .env.local in the project root directory.
   • Add the following lines to the .env.local file:

# .env.local

NEXT_PUBLIC_OPEN_AI_API_KEY=your-openai-api-key
NEXT_PUBLIC_GOOGLE_BOOKS_API_KEY=your-google-books-api-key

5. Start the development server:

npm run dev

6. Open your browser and visit http://localhost:3000 to see the application running.

Contributing

Contributions are welcome! If you find any issues or have suggestions for improvement, please create an issue or submit a pull request.

Contact

If you have any questions or feedback about BookishGenie, please contact me at [email protected].