🤖 gemini-personal-assistant

A personal assistant chatbot powered by Google Gemini 3.0 Flash preview — completely free, no credit card needed.

---

Why Gemini API?

Feature	Details
Free tier	✅ Yes — no credit card required
Requests/min	15 RPM
Requests/day	1,500 RPD
Tokens/min	1,000,000 TPM
Model	gemini-3-flash-preview (fast & capable)

---

Setup (Step-by-Step)

1. Get your free API key

Go to → https://aistudio.google.com/app/api-keys

• Sign in with your Google account
• Click "Create API Key"
• Copy the key

2. Install dependencies

npm install

3. Create your .env file

cp .env.example .env

Open .env and paste your key:

GEMINI_API_KEY=AIza...your_key_here
PORT=3000

4. Start the server

npm start

5. Open the app

Visit http://localhost:3000 and start chatting!

---

Project Structure

gemini-assistant/
├── server.js          # Express server + Gemini API
├── package.json       # Dependencies
├── .env               # Your API key (never commit!)
├── .env.example       # Template
├── .gitignore
└── public/
    └── index.html     # Frontend UI + chat logic

---

API Endpoints

Method	Endpoint	Description
POST	/api/chat	Send message, get Gemini reply
POST	/api/clear	Clear session history
GET	/api/health	Health check + model info