🚀 How to Run the Application

Follow these steps to set up your environment and launch the Streamlit app.

1. Create a Virtual Environment (First time only)

Open your terminal in the project root folder and run:

• Windows:

  python -m venv .venv

• macOS / Linux:

  python3 -m venv .venv

2. Activate the Virtual Environment

Choose the command that matches your Operating System and Terminal:

• Windows (Command Prompt):

  .venv\Scripts\activate.bat

• Windows (PowerShell):

  .venv\Scripts\Activate.ps1

• macOS / Linux:

  source .venv/bin/activate

3. Install Dependencies

Once your virtual environment is active (you should see (.venv) at the beginning of your terminal line), install the required packages:

pip install -r requirements.txt

4. Add API Keys

Create a directory called .streamlit and add a file secrets.toml with the following contents:

# .streamlit/secrets.toml
GEMINI_API_KEY = "YOUR_API_KEY_HERE"

5. Launch the App

Run the Streamlit server to open the app in your browser:

streamlit run app.py

💡 Tip: If the browser doesn't open automatically, copy and paste the Local URL (usually http://localhost:8501) from your terminal into your web browser.