README.md

---
title: OmegaCode — Holographic Master Code Demo
emoji: 🧬
colorFrom: indigo
colorTo: purple
sdk: gradio
app_file: app.py
pinned: false
license: mit
---

# OmegaCode — Holographic Master Code Demo

A research-oriented, physics-inspired neural prototype with an α-sensitive stability control and interference-based visualization.

## Live visual summary

![Loss curve](assets/loss_curve.png)

![Interference diagram](assets/interference_diagram.png)

## What this Space shows

- a lightweight **Master Code Ψ** prototype
- an **effective α parameter** that modulates phase and stability
- a **training-loss visualization** that changes near the nominal α value
- a **double-slit analogue** showing how phase coherence affects interference visibility

## How to use the demo

Move the **α slider** and compare:

- the training curve
- the interference pattern
- the model diagnostics panel

The demo updates interactively when you change **α**, epoch count, or input noise.

## Important note

This is an **experimental research prototype** and not a validated physical theory.  
It is designed as a conceptual, physics-inspired demo for learning and exploration.

## How to run locally

```bash
pip install -r requirements.txt
python app.py
```

## Files

- `app.py` — Gradio interface with interactive α control
- `model.py` — lightweight demo model and synthetic curves
- `assets/loss_curve.png` — static visualization for the README
- `assets/interference_diagram.png` — double-slit analogue for the README
- `requirements.txt` — dependencies