Metadata-Version: 2.4
Name: gemini-omega
Version: 0.1.0
Summary: Google Gemini SDK with OmegaEngine governance
Project-URL: Homepage, https://omegaengine.ai
Project-URL: Repository, https://github.com/TheArkhitect/Omegaengine
Author-email: OmegaEngine <team@omegaengine.ai>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: ai-safety,gemini,google,governance,omegaengine
Requires-Python: >=3.8
Requires-Dist: google-generativeai>=0.3.0
Requires-Dist: httpx>=0.24.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Description-Content-Type: text/markdown

<p align="center">
  <img src="logo.png" alt="OmegaEngine Logo" width="200" height="200">
</p>

<h1 align="center">gemini-omega</h1>

<p align="center">
  <strong>Google Gemini Integration with OmegaEngine Governance</strong>
</p>

<p align="center">
  <a href="https://pypi.org/project/gemini-omega/"><img src="https://img.shields.io/pypi/v/gemini-omega?color=blue&label=PyPI" alt="PyPI"></a>
  <a href="https://www.npmjs.com/package/@omegaengine/gemini"><img src="https://img.shields.io/npm/v/@TheArkhitect/Omegaengine?color=blue" alt="npm"></a>
  <a href="https://github.com/TheArkhitect/Omegaengine/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue" alt="License"></a>
</p>

---

## ✨ Features

- 🤖 **Drop-in Replacement** — Same API as Google GenAI SDK
- 🛡️ **Multi-modal Governance** — Text, images, audio, video
- 📊 **Response Filtering** — Policy-based output control
- 📈 **Full Audit Trail** — Log all Gemini interactions
- ⚡ **Streaming Support** — Governed streaming
- 🔧 **Function Calling** — Validate tool executions

---

## 📦 Installation

```bash
pip install gemini-omega
```

---

## 🚀 Quick Start

```python
from gemini_omega import GenerativeModel

model = GenerativeModel(
    model_name="gemini-1.5-pro",
    google_api_key="your-google-key",
    omega_api_key="your-omega-key",
    policy_id="gemini_policy",
)

response = model.generate_content("Explain black holes")

print(response.text)
print(response.omega_decision)  # "APPROVE"
print(response.omega_audit_id)  # "aud_xyz789"
```

---

## 🖼️ Multi-modal Governance

```python
import PIL.Image

image = PIL.Image.open("document.jpg")

response = model.generate_content([
    "What's in this image?",
    image
])

# Image content is also governed
print(response.omega_decision)
```

---

## 📄 License

Licensed under the [Apache License 2.0](LICENSE).
