Repository navigation
Releases
Releases · miticojo/gemini-sre-client
v0.1.0
Fixed
- 🐛 Added
.aioattribute toAsyncGeminiSREClientfor easier access to the underlyingAsyncGenerativeModel(fixes #1).
Changed
- ⬆️ Updated
google-genaito version1.56.0for latest features and security. - 🚀 Bumped version to
0.1.0for stable baseline and upcoming release. - 🔧 Updated
run-gemini-cliaction tov0.1.18and refined triage workflow instructions.
v0.0.1 - Initial Production-Ready Release
🎉 First Release: Production-Ready Gemini SRE Client
This is the initial production-ready release of , an enterprise-grade wrapper for Google's Gemini API with comprehensive SRE features.
✨ Core Features
🚀 Production SRE Features
- ⚡ Automatic retry with exponential backoff and jitter
- 🌍 Multi-region failover support (us-central1, europe-west1, europe-west3)
- 🔌 Circuit breaker pattern for intelligent region health tracking
- 📊 Cloud Monitoring integration with custom metrics
- 📝 Structured logging with Google Cloud Logging
🔧 API Features
- ⚙️ Async support with
AsyncGeminiSREClient - ✅ Type-safe structured output with Pydantic schema validation
- 📁 File operations with automatic deduplication
- 💬 Chat operations with context preservation
- 🌊 Streaming responses with real-time output
📊 Observability
- Request latency metrics (p50, p95, p99)
- Success/failure counters
- Retry count tracking
- Circuit breaker state monitoring
- Structured logs with request correlation
📦 Installation
pip install gemini-sre🚀 Quick Start
from gemini_sre import GeminiSREClient
# Initialize with SRE features
client = GeminiSREClient(
project_id="your-project-id",
locations=["us-central1", "europe-west1"],
enable_region_failover=True,
enable_circuit_breaker=True,
)
# Generate content
response = client.models.generate_content(
model="gemini-2.5-flash",
contents="Hello, Gemini!",
)
print(response.text)📚 Examples
This release includes 16 comprehensive examples:
- 4 basic examples (generation, streaming, chat, structured output)
- 5 advanced examples (multi-region, circuit breaker, retry, monitoring, files)
- 4 async examples (basic, streaming, concurrent requests, chat)
- 3 production examples (error handling, logging, best practices)
🧪 Testing & Quality
- 62 unit tests with 69% coverage
- Pre-commit hooks (black, isort, ruff, bandit, pytest)
- CI/CD pipeline with GitHub Actions
- Tested on Python 3.9, 3.10, 3.11, 3.12
📖 Documentation
- README.md - Getting started guide
- SETUP.md - Installation and configuration
- CONTRIBUTING.md - Contribution guidelines
- Examples directory - Working code examples
🔗 Links
- PyPI: https://pypi.org/project/gemini-sre/
- Repository: https://github.com/miticojo/gemini-sre-client
- Issues: https://github.com/miticojo/gemini-sre-client/issues
📄 License
MIT License - see LICENSE file for details.
Full Changelog: https://github.com/miticojo/gemini-sre-client/blob/main/CHANGELOG.md