GeminiProChat Documentation

Minimal web UI for GeminiPro.

4,902 stars TypeScript TypeScript 1 file Β· ~1,196 tokens #astro#gemini#gemini-api#gemini-client#gemini-pro#gemini-server#google#google-api
RAW Doc

Docker & Self-Hosted Deployment Verified OCI

Deploy GeminiProChat on any server, homelab, or cloud container platform.

1-Click Terminal Command
bash (docker run) 
docker run -d --name geminiprochat -p 3000:3000 --restart always babaohuang/geminiprochat:latest
Configured Services & Ports
βš™οΈ geminiprochat
image: build locally
πŸ”Œ Ports: 3000:3000
docker-compose.yml
yaml (docker-compose.yml) 
version: '3'

services:
  geminiprochat:
    build: .
    container_name: geminiprochat
    restart: always
    ports:
      - "3000:3000"
    environment:
      - GEMINI_API_KEY=YOUR_GEMINI_API_KEY
      # - HTTPS_PROXY=YOUR_HTTPS_PROXY
      # - API_BASE_URL=YOUR_GEMINI_API_BASE_URL
      # - HEAD_SCRIPTS=YOUR_HEAD_SCRIPTS
      # - PUBLIC_SECRET_KEY=YOUR_SECRET_KEY
      # - SITE_PASSWORD=YOUR_SITE_PASSWORD
      # - OPENAI_API_MODEL=YOUR_OPENAI_API_MODEL
      # - GEMINI_MODEL_NAME=gemini-2.5-flash

Technical Documentation: babaohuang/GeminiProChat

ℹ️ Provenance: Multi-Tier Ingestion Β· CodeWiki Reference

Overview (`README.md`)

GeminiProChat

English | δΈ­ζ–‡ | Italiano | ζ—₯本θͺž

Minimal web UI for Gemini Pro Chat.

[!WARNING]
Disclaimer: This project is not affiliated with, endorsed by, or sponsored by Google. It is an independent project that uses Google's Gemini Pro API.

Live demo: Gemini Pro Chat

Deploy

Just click the button above and follow the instructions to deploy your own copy of the app.

Deploy on Railway

Just click the button above and follow the instructions to deploy on Railway.

Deploy on Zeabur

Just click the button above and follow the instructions to deploy on Zeabur.

Deploy With Docker

To deploy with Docker, you can use the following command:

bash
docker run --name geminiprochat \
--restart always \
-p 3000:3000 \
-itd \
-e GEMINI_API_KEY=your_api_key_here \
babaohuang/geminiprochat:latest

Please make sure to replace your_api_key_here with your own GEMINI API key.

This will start the geminiprochat service, accessible at http://localhost:3000.

Environment Variables

You can control the website through environment variables.

Name Description Required
GEMINI_API_KEY Your API Key for GEMINI. You can get it from here. βœ”
API_BASE_URL Custom base url for GEMINI API. Click here to see when to use this. ❌
HEAD_SCRIPTS Inject analytics or other scripts before </head> of the page ❌
PUBLIC_SECRET_KEY Secret string for the project. Use for generating signatures for API calls ❌
SITE_PASSWORD Set password for site, support multiple password separated by comma. If not set, site will be public ❌
GEMINI_MODEL_NAME Customize the Gemini model to use. Defaults to gemini-2.5-flash if not set ❌

Running Locally

Pre environment

  1. Node: Check that both your development environment and deployment environment are using Node v18 or later. You can use nvm to manage multiple node versions locally.

    bash
    node -v

  2. PNPM: We recommend using pnpm to manage dependencies. If you have never installed pnpm, you can install it with the following command:

    bash
    npm i pnpm

  3. GEMINI_API_KEY: Before running this application, you need to obtain the API key from Google. You can register the API key at https://makersuite.google.com/app/apikey.

Getting Started

  1. Install dependencies

    bash
    pnpm install

  2. Copy the .env.example file, then rename it to .env, and add your GEMINI_API_KEY to the .env file.

    bash
    GEMINI_API_KEY=AIzaSy...

  3. Run the application, the local project runs on http://localhost:3000/.

    bash
    pnpm run dev

Acknowledgements

This project is inspired by and based on the following open-source project:

  • ChatGPT-Demo - For the foundational codebase and features.

Star History

Buy me a coffee

If this repo is helpful to you, buy me a coffee,thank you very much!πŸ˜„

ElevenMusic | World's best AI music generator

--- METRICS ---

Explore Related Technologies & Topics

View All 9,111+ Repositories β†’

Discover similar high-velocity repositories, agent skills, and OpenAPI specifications across the ecosystem.

#astro Browse astro catalog β†’ #gemini Browse gemini catalog β†’ #gemini-api Browse gemini-api catalog β†’ #gemini-client Browse gemini-client catalog β†’ #gemini-pro Browse gemini-pro catalog β†’ #gemini-server Browse gemini-server catalog β†’ ⚑ MCP Servers Model Context Protocol β†’ 🧠 Agent Skills Prompt & rule files β†’ πŸ”Œ OpenAPI Specs REST & Swagger schemas β†’