README.md

---
title: Gemini AI API (No Login)
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
tags:
  - api
  - playwright
  - gemini
---

# 🤖 Gemini AI API (Headless & No-Login)

This is a FastAPI-based wrapper for Google Gemini that runs on Hugging Face Spaces using Playwright. It operates in **Guest Mode** (no login required), opens a fresh browser session for every request, and automatically cleans up afterwards to ensure privacy and stability.

## ✨ Features

-   🔓 **No Login Required:** Runs in guest mode; no cookies or user_data needed.
-   🧹 **Auto-Cleanup:** Fresh browser instance for every API call.
-   🖼️ **Image Support:** Automatically downloads generated images and uploads them to ImgBB.
-   ⚡ **FastAPI:** High-performance async API endpoints.
-   🐳 **Dockerized:** Pre-configured with Chromium and all dependencies.

## 🚀 Setup Instructions

### 1. Create a Hugging Face Space
-   Select **Docker** as the SDK.
-   Upload `app.py`, `requirements.txt`, and `Dockerfile`.

### 2. Configure Secrets
Go to your Space **Settings > Variables and Secrets** and add:
-   `IMGBB_API_KEY`: Your API key from [ImgBB](https://api.imgbb.com/) (Required for image uploads).

### 3. Files Required
Ensure these files are in your repository:
-   `app.py` (Main application code)
-   `requirements.txt` (Dependencies)
-   `Dockerfile` (Installs Chromium + Python deps)

## 📡 API Usage

### Endpoint: `/chat`
**Method:** `POST`  
**Content-Type:** `application/json`

#### Request Body
```json
{
  "message": "Your prompt here"
}