kasmweb/gemini-cli repository overview

Kasm Workspaces is a docker container streaming platform for delivering browser-based access to desktops, applications, and web services.

⁠Live Demo

Launch a real-time demo in a new browser window: Live Demo⁠.

∗Note: Demo is limited to 3 minutes and has upload/downloads restricted for security purposes.

⁠Get Started

Try out our no-cost Community Edition: Download⁠.

Our Kasm Workspaces team has open-sourced our library of images (Info⁠ & Source Code⁠).

The web-native rendering is powered by our open-source project: KasmVNC⁠.

⁠About This Image

This Image contains a browser-accessible Ubuntu Jammy Desktop with Gemini CLI, Google's command-line interface for interacting with Gemini AI models directly from your terminal.

⁠Environment Variables

⁠Gemini CLI Configuration

• GEMINI_API_KEY - Your Google Gemini API key (starts with AIza). This is required for Gemini CLI to authenticate with the Google AI API. If you don't want to use an API key, you can use browser login flow to login to your Gemini account.

You can pass this environment variable to your Gemini CLI Workspace with Docker Run Config Override (JSON) in your Workspace settings.

Alternatively, you can use the Launch Form to input your API key when starting the workspace. The Launch Form allows you to:

• Enable API key authentication
• Input your Google Gemini API key securely
• Save your preferences for future launches

The workspace will automatically configure Gemini CLI to use your API key.

⁠Stand-alone Deployment

This image was designed to run natively within Kasm Workspaces, but it can also be deployed stand-alone and accessed through a web browser.

sudo docker run --rm -it --shm-size=512m -p 6901:6901 -e VNC_PW=password kasmweb/gemini-cli:1.18.0

The container is now accessible via a browser : https://IP_OF_SERVER:6901

• User : kasm_user
• Password: password

Please note that some functionality, such as audio, uploads, downloads, and microphone pass-through, is only available when using Kasm Workspaces for orchestration.

⁠Tags

• 1.18.0

  • Images are built and tagged with the Kasm Workspaces release version.

• 1.18.0-rolling

  • Rolling tags are images that are updated and built nightly to ensure your images are running the latest version.

• develop

  • The develop tag is for testing and provides no expectation of compatibility.

⁠Additional Info

• Source Code

  • KasmVNC GitHub⁠: Open-Source VNC server: web-native, secure, high-performance.
  • Images GitHub⁠: Library of Workspaces Docker images.
  • Core Images GitHub⁠: Library of core OS baselines for custom images.

• Workspaces Documentation

  • Developer API⁠: Integrate with your applications and workflows.
  • Workspaces⁠: Instructions for installing and configuring Kasm Workspaces.
  • Custom Images⁠: Info on configuring custom images and installing software.

• Reporting Issues

  • Issue Tracker GitHub⁠: Community issue reporting.