bprep ✨

Prepare for anything ;)

bprep is an AI-powered agent that helps you prepare for anything at the last moment by presenting you with a short 5-question AI-generated quiz. This project leverages a free model from OpenRouter—no need to buy OpenAI credits. Special thanks to Agno for making this project even more fun than expected!

---

demo.mp4

---

Features

• Quick, 5-question AI-generated quiz to help you prepare anything.
• MCQ Agent using Agno.
• Works with free gemini models from Openrouter

---

Stack

• Frontend: NextJS
• Backend: FastAPI

---

Frontend Setup

cd frontend

1. Install Dependencies:

   pnpm install

2. Start the Development Server:

   pnpm dev

---

Backend Setup

cd backend

1. Create a Python Virtual Environment:

   python3 -m venv .venv

2. Activate the Virtual Environment:

   On macOS/Linux:

   source .venv/bin/activate

   On Windows:

   .venv\Scripts\activate

3. Install Dependencies:

   pip install -r requirements.txt

4. Set Your OpenRouter API Key:

   export OPENROUTER_API_KEY="KEY"

5. Run the FastAPI Development Server:

   fastapi dev

---

Getting Started

• Frontend: After running pnpm dev, open your browser and go to http://localhost:3000 to see the app in action.
• Backend: The FastAPI server will run on the configured port (default is typically 8000) and handle all API requests.

---

Happy coding!