Gemini STT
Transcribe audio files using Google's Gemini API or Vertex AI Skill: Gemini STT Summary: Transcribe audio files using Google's Gemini API or Vertex AI Tags: latest:1.1.0 Version history: v1.1.0 | 2026-01-17T12:06:21.889Z | user Added support for Google Vertex AI with Application Default Credentials (ADC). Now supports both GEMINI_API_KEY and gcloud ADC authentication methods. Auto-detects authentication method. v1.0.0 | 2026-01-13T18:18:30.222Z | user Initial release of Gemini-
Rank
62
Safety
84
Downloads
2.5k
Updated
Apr 15, 2026
Version
1.1.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 2.5K downloads reported by the source. Last updated 4/15/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Apr 15, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Apr 15, 2026
- Adoption signal
- 2.5K downloadsadoption · observed Apr 15, 2026
- Latest release
- 1.1.0release · observed Jan 17, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install unknown:gemini-stt- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-unknown-gemini-stt/snapshot"
Documentation
CLAWHUB
7,215 characters of source documentation, loaded on request.
Extracted files
2 files captured from the source.
SKILL.md
---
name: gemini-stt
description: Transcribe audio files using Google's Gemini API or Vertex AI
metadata: {"clawdbot":{"emoji":"🎤","os":["linux","darwin"]}}
---
# Gemini Speech-to-Text Skill
Transcribe audio files using Google's Gemini API or Vertex AI. Default model is `gemini-2.0-flash-lite` for fastest transcription.
## Authentication (choose one)
### Option 1: Vertex AI with Application Default Credentials (Recommended)
```bash
gcloud auth application-default login
gcloud config set project YOUR_PROJECT_ID
```
The script will automatically detect and use ADC when available.
### Option 2: Direct Gemini API Key
Set `GEMINI_API_KEY` in environment (e.g., `~/.env` or `~/.clawdbot/.env`)
## Requirements
- Python 3.10+ (no external dependencies)
- Either GEMINI_API_KEY or gcloud CLI with ADC configured
## Supported Formats
- `.ogg` / `.opus` (Telegram voice messages)
- `.mp3`
- `.wav`
- `.m4a`
## Usage
```bash
# Auto-detect auth (tries ADC first, then GEMINI_API_KEY)
python ~/.claude/skills/gemini-stt/transcribe.py /path/to/audio.ogg
# Force Vertex AI
python ~/.claude/skills/gemini-stt/transcribe.py /path/to/audio.ogg --vertex
# With a specific model
python ~/.claude/skills/gemini-stt/transcribe.py /path/to/audio.ogg --model gemini-2.5-pro
# Vertex AI with specific project and region
python ~/.claude/skills/gemini-stt/transcribe.py /path/to/audio.ogg --vertex --project my-project --region us-central1
# With Clawdbot media
python ~/.claude/skills/gemini-stt/transcribe.py ~/.clawdbot/media/inbound/voice-message.ogg
```
## Options
| Option | Description |
|--------|-------------|
| `<audio_file>` | Path to the audio file (required) |
| `--model`, `-m` | Gemini model to use (default: `gemini-2.0-flash-lite`) |
| `--vertex`, `-v` | Force use of Vertex AI with ADC |
| `--project`, `-p` | GCP project ID (for Vertex, defaults to gcloud config) |
| `--region`, `-r` | GCP region (for Vertex, default: `us-central1`) |
## Supported Models
Any Gemini model that supports audio input can be used. Recommended models:
| Model | Notes |
|-------|-------|
| `gemini-2.0-flash-lite` | **Default.** Fastest transcription speed. |
| `gemini-2.0-flash` | Fast and cost-effective. |
| `gemini-2.5-flash-lite` | Lightweight 2.5 model. |
| `gemini-2.5-flash` | Balanced speed and quality. |
| `gemini-2.5-pro` | Higher quality, slower. |
| `gemini-3-flash-preview` | Latest flash model. |
| `gemini-3-pro-preview` | Latest pro model, best quality. |
See [Gemini API Models](https://ai.google.dev/gemini-api/docs/models) for the latest list.
## How It Works
1. Reads the audio file and base64 encodes it
2. Auto-detects authentication:
- If ADC is available (gcloud), uses Vertex AI endpoint
- Otherwise, uses GEMINI_API_KEY with direct Gemini API
3. Sends to the selected Gemini model with transcription prompt
4. Returns the transcribed text
## Example Integration
For Clawdbot voice message handling:
```bash
# Transcribe incoming voice message
TRANSCRIP_meta.json
{
"ownerId": "kn74rm3nhtpv387m12frad6bws7z5kqr",
"slug": "gemini-stt",
"version": "1.1.0",
"publishedAt": 1768651581889
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/araa47/gemini-stt",
"sourceUrl": "https://clawhub.ai/araa47/gemini-stt",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-unknown-gemini-stt/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-unknown-gemini-stt/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "2.5K downloads",
"href": "https://clawhub.ai/unknown/gemini-stt",
"sourceUrl": "https://clawhub.ai/unknown/gemini-stt",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.1.0",
"href": "https://clawhub.ai/unknown/gemini-stt",
"sourceUrl": "https://clawhub.ai/unknown/gemini-stt",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-01-17T12:06:21.889Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-unknown-gemini-stt/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-unknown-gemini-stt/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.1.0",
"description": "Added support for Google Vertex AI with Application Default Credentials (ADC). Now supports both GEMINI_API_KEY and gcloud ADC authentication methods. Auto-detects authentication method.",
"href": "https://clawhub.ai/unknown/gemini-stt",
"sourceUrl": "https://clawhub.ai/unknown/gemini-stt",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-01-17T12:06:21.889Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
