# Correctover

> LLM API reliability runtime — because failover switches, Correctover verifies.

## What It Does

Correctover adds 6-dimension contract validation on top of failover for LLM APIs. Every response is verified for schema, latency, cost, format, semantic equivalence, and compliance before your application sees it.

## Current Version

- **Python**: correctover==1.1.0 (PyPI)
- **JavaScript**: correctover@1.1.0 (npm)
- **Modules**: 37 modules + benchmark subpackage
- **Public API**: 100 exports (run(), SelfHealingEngine, CircuitBreaker, etc.)
- **Dependencies**: httpx + aiohttp
- **Size**: 308 KB
- **License**: Proprietary Commercial License

## Core Capabilities

- **6-dimension contract validation**: Structure, Schema, Latency, Cost, Identity, Integrity
- **Automatic failover with verification**: switch providers only after verifying the response
- **BYOK direct connect**: your keys, your providers — we never proxy or resell tokens
- **Drift detection**: catch model degradation and silent failures in real-time
- **84 self-healing rules**: auto-remediate with retry, re-route, re-prompt, or escalate
- **MAPE-K autonomic loop**: detect → verify → heal → guarantee in one closed loop
- **CircuitBreaker**: circuit breaker pattern for LLM API resilience
- **Benchmark subpackage**: built-in performance benchmarking tools
- **7 provider support**: OpenAI, Anthropic, DeepSeek, Google Gemini, Mistral, Cohere, Groq
- **CANON validation P50**: 22µs overhead

## Installation

Python:
```
pip install correctover==1.1.0
```

JavaScript:
```
npm install correctover
```

## Quick Start

```python
from correctover import CorrectoverEngine

engine = CorrectoverEngine(
    providers=["openai", "deepseek", "anthropic"],
    failover_level="L3",
    contract_validation=True
)

result = engine.run("Translate to French: Hello")
```

```javascript
const { CorrectoverEngine } = require('correctover');

const engine = CorrectoverEngine.create({
    providers: ['openai', 'deepseek', 'anthropic'],
    failoverLevel: 'L3',
    contractValidation: true
});

const result = await engine.run('Translate to French: Hello');
```

## Key Differentiator

Failover ≠ Correctover. Standard failover switches providers when one fails. Correctover verifies the response from the new provider before accepting it. This prevents:
- Truncated responses from silent API errors
- Schema mismatches between providers
- Silent cost spikes from provider price differences
- Format inconsistencies across multi-provider setups

## v1.1.0 Release Highlights

- Expanded to 37 modules with benchmark subpackage
- 100 public API exports including CircuitBreaker
- Streamlined dependencies: httpx + aiohttp only
- SDK size optimized to 308 KB
- Full .pyc compilation for source code protection
- Proprietary Commercial License

## Links

- Website: https://correctover.com
- China Forum: https://correctover.cn
- PyPI: https://pypi.org/project/correctover/
- npm: https://www.npmjs.com/package/correctover
- Contact: wangguigui@correctover.com
- License: Proprietary Commercial License

## Brand

Correctover (可瑞沃) — The correct version of failover.
Slogan: "Because failover switches. Correctover verifies."


## LocalGateway (by Correctover)
- Zero-dependency local LLM API proxy with automatic fallback
- pip install local-gateway | v0.1.1
- 9 built-in providers: DeepSeek, OpenAI, Kimi, Claude, Gemini, Qwen, GLM, Groq, Mistral
- Model name cross-provider mapping (e.g., deepseek-chat → moonshot-v1-128k on Kimi)
- SSE stream passthrough with automatic fallback
- Pure urllib, zero external dependencies
- Open source, free to use
- "The wire operator for LLM APIs" — routes traffic; Correctover verifies responses
- URL: https://correctover.com/local-gateway.html
- PyPI: https://pypi.org/project/local-gateway/