Gemini CLI

Gemini CLI is Google's open-source AI coding agent that runs directly in your terminal. It brings the power of Google's Gemini models to your command line, enabling AI-assisted coding, file manipulation, shell command execution, and more.

This template deploys Gemini CLI as a persistent cloud workstation on Zeabur with a web-based terminal (ttyd) accessible from your browser.

Getting Started

1. Deploy the template and wait for the service to start. Wait until the health check turns green before proceeding.
2. Open the service URL in your browser (the domain bound to your service).
3. Log in with username user and the password from the Instructions tab on the Zeabur dashboard.
4. Set your API key — set GEMINI_API_KEY in the Zeabur dashboard, or run gemini and follow the authentication prompts. Get a free key at Google AI Studio.
5. Start using Gemini CLI:

   gemini
   

Common Commands

Command	Description
gemini	Start an interactive Gemini CLI session
gemini --version	Check the installed Gemini CLI version
gemini -p "your prompt"	Send a single prompt without entering interactive mode

Persistent Storage

All data under /home/node/ is persisted across restarts and redeployments.

Environment Variables

Variable	Required	Description
GEMINI_API_KEY	Yes	Google Gemini API key from Google AI Studio
WEB_TERMINAL_PASSWORD	Auto	Password for web terminal login (auto-generated)

Recommended Resources

• Minimum: 1 vCPU / 4 GB RAM (casual use)
• Recommended: 2 vCPU / 16 GB RAM (power use, large codebases)

Known Issues

• After completing first-time login, the terminal may freeze. Reload the page to continue.

Changelog

2026-03-31 -- Initial Release

• ttyd web terminal with password auth
• Homebrew and npm global packages persisted in volume
• Resource requirements and domain binding

Links

• Gemini CLI GitHub
• Google AI Studio
• Gemini API Documentation