XSpoonAi Gemini Vision Analyzer
A robust SpoonOS skill for analyzing images using Google's Gemini 2.0 Flash model. It is designed for production environments with built-in support for HTTP proxies, automatic retries for rate limits, and a mock mode for testing without API costs.
Quick Start
from spoon.skills.gemini_vision import vision_analyze
# Analyze an image
with open("image.jpg", "rb") as f:
image_bytes = f.read()
result = await vision_analyze(
image=image_bytes,
prompt="Describe this image"
)
print(result)
Scripts
| Script | Purpose |
|---|---|
| main.py | Main implementation of the vision analysis logic |
Environment Variables
| Variable | Required | Description |
|---|---|---|
GEMINI_API_KEY |
Yes | Your Google Gemini API key |
HTTPS_PROXY |
No | Proxy URL (e.g., http://127.0.0.1:7890) |
MOCK_VISION |
No | Set to true to enable mock mode |
GEMINI_MODEL |
No | Model name (default: gemini-2.5-flash) |
Best Practices
- Use Mock Mode for Dev: Set
MOCK_VISION=trueduring development to save API quota. - Handle Proxies: If you are in a region where Google API is restricted, ensure
HTTPS_PROXYis set. - Structured Prompts: The skill automatically appends JSON formatting instructions, so focus your prompt on what to analyze.