Metadata-Version: 2.2
Name: correctover
Version: 1.0.0
Summary: The correct version of failover — protocol-level contract validation with automatic failover for LLM APIs
Home-page: https://correctover.com
Author: Guigui Wang
Author-email: Guigui Wang <wanggui.gui@correctover.com>
License: Apache-2.0 WITH commercial-restriction
Project-URL: Homepage, https://correctover.com
Project-URL: Repository, https://github.com/correctover/correctover
Keywords: ai,llm,failover,self-healing,contract-validation,openai,anthropic,reliability,sdk
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.24.0
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# Correctover SDK

**The correct version of failover.**

Because failover switches. Correctover verifies.

## What It Does

Correctover is an embedded reliability runtime for LLM APIs. It provides:

- **Contract Validation** — Verify responses match expected schema, not just HTTP 200
- **Automatic Failover** — Switch providers when contracts are violated
- **Drift Detection** — Catch silent model substitutions and schema drift
- **6-Dimension Verification** — Structure, schema, latency, cost, identity, integrity

## Quick Start

```bash
pip install correctover
```

```python
from correctover import Correctover

# Drop-in replacement for openai.OpenAI
client = Correctover(api_key="sk-xxx")
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}],
)
```

## Why Correctover, Not Just Failover?

| | Failover | Correctover |
|---|---|---|
| Switches provider? | ✅ | ✅ |
| Validates the response? | ❌ | ✅ |
| Detects silent model swap? | ❌ | ✅ |
| Catches schema drift? | ❌ | ✅ |
| Prevents cost overruns? | ❌ | ✅ |

Failover switches. **Correctover verifies.**

## Performance

| Metric | Value |
|---|---|
| Contract validation overhead | 22μs P50 |
| Fault diagnosis rules | 87+ |
| Package size | <500KB |
| External dependencies | 1 (httpx) |
| Data accessed | None (runs locally) |

## License

Apache-2.0 WITH commercial-restriction.

Free for development and non-commercial use. Commercial license required for production deployments.

© 2026 Guigui Wang. All rights reserved.
