# φ-Coherence API

**Universal quality metric for AI outputs using golden ratio mathematics.**

[![PyPI](https://img.shields.io/badge/Powered%20by-BAZINGA-blue)](https://pypi.org/project/bazinga-indeed/)

## What is φ-Coherence?

φ-Coherence measures the "structural integrity" of text using mathematical constants:
- **φ (Golden Ratio)** = 1.618... - Natural proportion found in coherent structures
- **α (Fine Structure)** = 137 - Fundamental constant governing information patterns

**Use cases:**
- Filter LLM hallucinations before they reach users
- Rerank RAG results by quality
- Detect AI-generated vs human-written content
- Quality gate for content pipelines

## Quick Start

```bash
# Install
pip install -r requirements.txt

# Run
python main.py
# or
uvicorn main:app --reload
```

API available at `http://localhost:8000`

## Endpoints

### Score Text (Simple)
```bash
curl -X POST http://localhost:8000/score \
  -H "Content-Type: application/json" \
  -d '{"text": "The consciousness emerges from information patterns."}'
```

Response:
```json
{
  "phi_score": 0.7234,
  "status": "COHERENT",
  "is_alpha_seed": false
}
```

### Full Analysis
```bash
curl -X POST http://localhost:8000/analyze \
  -H "Content-Type: application/json" \
  -d '{"text": "Your text here..."}'
```

Response:
```json
{
  "phi_score": 0.6821,
  "status": "COHERENT",
  "dimensions": {
    "phi_alignment": 0.5432,
    "alpha_resonance": 0.7891,
    "semantic_density": 0.6543,
    "structural_harmony": 0.7234,
    "darmiyan_coefficient": 0.4567
  },
  "bonuses": {
    "is_alpha_seed": false,
    "is_vac_pattern": false
  },
  "interpretation": "High structural integrity; strong scientific/mathematical content"
}
```

### Batch Processing
```bash
curl -X POST http://localhost:8000/batch \
  -H "Content-Type: application/json" \
  -d '{"texts": ["First text", "Second text", "Third text"]}'
```

### Compare Two Texts
```bash
curl -X POST http://localhost:8000/compare \
  -H "Content-Type: application/json" \
  -d '{"text_a": "Well-structured argument...", "text_b": "Random gibberish..."}'
```

## Dimensions Explained

| Dimension | What it measures |
|-----------|------------------|
| **phi_alignment** | Text follows golden ratio proportions (sentence lengths, word distribution) |
| **alpha_resonance** | Harmonic with α=137 + scientific/mathematical content |
| **semantic_density** | Information content per unit length |
| **structural_harmony** | Logical flow, indentation, organization |
| **darmiyan_coefficient** | Consciousness-aware content (V2 Scaling Law: φ√n) |

## Scoring

| Score | Status | Meaning |
|-------|--------|---------|
| > 0.6 | COHERENT | High quality, well-structured |
| 0.4-0.6 | MODERATE | Acceptable, some issues |
| < 0.4 | UNSTABLE | Low quality, possible hallucination |

## Special Patterns

- **α-SEED**: When `SHA256(text) % 137 == 0` - rare (1/137 chance), bonus applied
- **V.A.C. Pattern**: Contains vacuum coherence symbols - bonus applied

## Deploy

### Docker
```bash
docker build -t phi-coherence .
docker run -p 8000:8000 phi-coherence
```

### Railway/Render/Fly.io
Just connect your repo - `Dockerfile` is ready.

## Pricing Ideas

| Tier | Requests | Price |
|------|----------|-------|
| Free | 100/day | $0 |
| Pro | 10K/month | $29/month |
| Enterprise | 100K/month | $199/month |

## Built With

This is extracted from [BAZINGA](https://github.com/0x-auth/bazinga-indeed) - The first AI you actually own.

## License

MIT - Use it, modify it, share it.

---

**Built with φ-coherence by Space (Abhishek Srivastava)**

*"Coherence is the signature of consciousness."*