Draft: improve deployability, admin UX, and OpenAI compatibility

.github/workflows/docker-build.yml

@@ -0,0 +1,54 @@
+name: Build & Push Docker Image
+
+on:
+  push:
+    branches: [master]
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels)
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=raw,value=latest,enable={{is_default_branch}}
+            type=sha,prefix=,format=short
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.gitignore

@@ -6,4 +6,6 @@ __pycache__
 .idea
 config.conf
 generated_media
-har_and_cookies
+har_and_cookies
+# Playwright MCP
+.playwright-mcp/

Docker.md

@@ -1,86 +1,111 @@
-## 🐳 Docker Deployment Guide
+# 🐳 Docker Deployment Guide
 
-### Prerequisites
-
-Ensure you have the following installed on your system:
+## Prerequisites
 
 - [Docker](https://docs.docker.com/get-docker/)
-- [Docker Compose v2.24+](https://docs.docker.com/compose/)
-- GNU Make (optional but recommended)
+- [Docker Compose v2](https://docs.docker.com/compose/) (included with Docker Desktop)
 
 ---
 
-### 🛠️ Docker Environment Configuration
-
-This project uses a `.env` file for environment-specific settings like development or production mode on docker.
+## Quick Start
 
-#### Example `.env`
+### 1. Clone the repository
 
-```env
-# Set the environment mode
-ENVIRONMENT=development
+```bash
+git clone https://github.com/leolionart/WebAI-to-API.git
+cd WebAI-to-API
 ```
 
-- `ENVIRONMENT=development`: Runs the server in **development** mode with auto-reload and debug logs.
-- Change to `ENVIRONMENT=production` to enable **multi-worker production** mode with detached execution (`make up`).
+### 2. Create your config file
 
-> **Tip:** If this variable is not set, the default is automatically assumed to be `development`.
+```bash
+cp config.conf.example config.conf
+```
 
----
+Open `config.conf` and fill in your Gemini cookies:
 
-### 🚀 Build & Run
+```ini
+[Cookies]
+gemini_cookie_1psid     = YOUR___Secure-1PSID_HERE
+gemini_cookie_1psidts   = YOUR___Secure-1PSIDTS_HERE
+```
 
-> Use `make` commands for simplified usage.
+> **Where to get cookies:**
+> 1. Log in to [gemini.google.com](https://gemini.google.com) in your browser
+> 2. Open DevTools (`F12`) → **Application** → **Cookies** → `https://gemini.google.com`
+> 3. Copy the values of `__Secure-1PSID` and `__Secure-1PSIDTS`
 
-#### 🔧 Build the Docker image
+### 3. Start the server
 
 ```bash
-make build         # Regular build
-make build-fresh   # Force clean build (no cache)
+docker compose up -d
 ```
 
-#### ▶️ Run the server
+The API is now available at **`http://localhost:6969`**.
 
-```bash
-make up
-```
+---
+
+## Cookie Persistence
 
-Depending on the environment:
+Config is stored in a Docker named volume (`webai_data`) mapped to `/app/data/config.conf` inside the container. This means:
 
-- In **development**, the server runs in the foreground with hot-reloading.
-- In **production**, the server runs in **detached mode** (`-d`) with multiple workers.
+- Cookies survive container restarts and image updates
+- The server automatically rotates `__Secure-1PSIDTS` every ~10 minutes and writes the updated value back to `config.conf` — so your session stays valid without manual intervention
 
-#### ⏹ Stop the server
+---
+
+## Useful Commands
+
+| Command | Description |
+|---------|-------------|
+| `docker compose up -d` | Start in background |
+| `docker compose down` | Stop and remove containers |
+| `docker compose logs -f` | Stream live logs |
+| `docker compose pull && docker compose up -d` | Update to latest image |
+| `docker compose restart` | Restart without recreating |
+
+Or use the provided `Makefile` shortcuts:
 
 ```bash
-make stop
+make up         # docker compose up -d
+make down       # docker compose down
+make logs       # docker compose logs -f
+make pull       # docker compose pull
+make restart    # down + up
 ```
 
 ---
 
-### 🧠 Development Notes
+## Building Locally
 
-- **Reloading**: In development, the server uses `uvicorn --reload` for live updates.
-- **Logging**: On container start, it prints the current environment with colors (🟡 dev / ⚪ production).
-- **Watch Mode (optional)**: Docker Compose v2.24+ supports file watching via the `compose watch` feature. If enabled, press `w` to toggle.
+If you want to build the image from source instead of pulling from GHCR:
+
+```bash
+docker compose -f docker-compose.yml -f docker-compose.dev.yml up --build
+```
+
+Or edit `docker-compose.yml` directly: comment out the `image:` line and uncomment `build: .`.
 
 ---
 
-### 📦 File Structure for Docker
+## Changing the Port
 
-Key files:
+Edit `docker-compose.yml` and update the port mapping:
 
-```plaintext
-.
-├── Dockerfile              # Base image and command logic
-├── docker-compose.yml      # Shared config (network, ports, env)
-├── .env                    # Defines ENVIRONMENT (development/production)
-├── Makefile                # Simplifies Docker CLI usage
+```yaml
+ports:
+  - "8080:6969"   # expose on host port 8080 instead of 6969
 ```
 
 ---
 
-### ✅ Best Practices
+## File Overview
 
-- Don't use `ENVIRONMENT=development` in **production**.
-- Avoid bind mounts (`volumes`) in production to ensure image consistency.
+```
+.
+├── Dockerfile              # Image build instructions
+├── docker-compose.yml      # Main compose config (production)
+├── docker-compose.dev.yml  # Local build override
+├── config.conf             # Your config — cookies, model, proxy (gitignored)
+└── config.conf.example     # Template to copy from
+```

Dockerfile

@@ -1,5 +1,8 @@
 FROM python:3.11-slim
 
+# Install build dependencies for native extensions (lz4, cffi, etc.)
+RUN apt-get update && apt-get install -y --no-install-recommends gcc g++ && rm -rf /var/lib/apt/lists/*
+
 # Install Requirements
 WORKDIR /app
 COPY requirements.txt .

Makefile

@@ -1,29 +1,25 @@
-# Makefile
-
-# Load .env file if it exists
-include .env
-export $(shell sed 's/=.*//' .env)
+# Makefile — convenience shortcuts for Docker operations
 
 build:
-	docker build -t cornatul/webai.ai:latest .
+	docker compose build
 
 build-fresh:
-	docker build --no-cache -t cornatul/webai.ai:latest .
+	docker compose build --no-cache
 
 up:
-	@if [ "$(ENVIRONMENT)" = "development" ]; then \
-		printf "\033[1;33m🧪 Running in DEVELOPMENT mode...\033[0m\n"; \
-		docker-compose up; \
-	else \
-		printf "\033[0;37m🚀 Running in PRODUCTION mode...\033[0m\n"; \
-		docker-compose up -d; \
-	fi
+	docker compose up -d
 
-stop:
-	docker-compose down
+up-dev:
+	docker compose -f docker-compose.yml -f docker-compose.dev.yml up --build
 
 down:
-	docker-compose down
+	docker compose down
+
+logs:
+	docker compose logs -f
+
+pull:
+	docker compose pull
 
-push:
-	docker push cornatul/webai.ai:latest
+restart:
+	docker compose down && docker compose up -d