Back to the catalog

gemini-media-generation

Gemini CLI extension for media generation

Open source Open in the app JSON README (API)

About

Gemini CLI extension for media generation

Details

Kind
Plugins
Topic
AI, RAG & memory
Publisher
rubans
Origin
gemini
Category
ferramentas
Version
1.0.0
Last push
2025-12-30T10:55:38Z
Repository state
ativo
Language
Python
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
rubans/gemini-media-generation

README

# Gemini Media Generation Extension

This project implements a Gemini CLI Extension (using the Model Context Protocol) that enables AI assistants to generate media using Google Cloud Vertex AI models.

## Purpose

The extension exposes tools that allow the Gemini CLI to generate high-quality images and videos directly from text prompts or input images. It acts as a bridge between the CLI and Google's generative AI models on Vertex AI.

## Tools

### `nanobanana_generate`
Generates images based on a text prompt.
- **Backend**: Vertex AI (default model: `gemini-2.5-flash-image`).
- **Features**: Supports text-to-image and image-to-image generation.

### `veo_generate_video`
Generates videos based on a text prompt.
- **Backend**: Vertex AI (default model: `veo-3.1-fast-generate-preview`).
- **Features**: Supports text-to-video and image-to-video generation.

## Configuration

The extension requires access to a Google Cloud project with Vertex AI enabled.

Create a `.env` file in the project root with the following variables:

```env
VERTEXAI_PROJECT=your-google-cloud-project-id
VERTEXAI_LOCATION=us-central1
# Optional Logging Configuration
LOG_LEVEL=INFO
LOG_FILE=gemini_media_gen.log
```

## Install the Extension

```bash
gemini extensions install https://github.com/rubans/gemini-media-generation.git
```

## Usage

### `nanobanana_generate`
```
Generate an image of a bouncing tennis ball
```
### `veo_generate_video`
```
Generate a video of a bouncing tennis ball  
```

## Running MCP Server
Add MCP Server
```
gemini mcp add "Gemini Media MCP" uv run --with fastmcp --with-requirements mcp\\requirements.txt fastmcp run mcp\\servers\\gemini_media_gen.py
```
Remove MCP Server
```
gemini mcp remove "Gemini Media MCP"
```

More