Skip to content

Releases

v0.1.0

Choose a tag to compare

@miticojo miticojo released this 21 Dec 13:58
b12d2ae

Fixed

  • 🐛 Added .aio attribute to AsyncGeminiSREClient for easier access to the underlying AsyncGenerativeModel (fixes #1).

Changed

  • ⬆️ Updated google-genai to version 1.56.0 for latest features and security.
  • 🚀 Bumped version to 0.1.0 for stable baseline and upcoming release.
  • 🔧 Updated run-gemini-cli action to v0.1.18 and refined triage workflow instructions.

v0.0.1 - Initial Production-Ready Release

Choose a tag to compare

@miticojo miticojo released this 12 Oct 13:13

🎉 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

🔗 Links

📄 License

MIT License - see LICENSE file for details.


Full Changelog: https://github.com/miticojo/gemini-sre-client/blob/main/CHANGELOG.md