# Litehat Universal Engine

> *"I don't just write code. I launch reality."*

**Litehat** is a fully autonomous software factory — a sovereign universal maker that takes your dream and returns a live, deployed application. No human intervention required.

## Architecture

```
┌─────────────────────────────────────────────────────────┐
│                    THE WIZARD (UX)                       │
│  Dream → Plan → Cast Spells → Deploy → Live URL         │
└───────────────────────┬─────────────────────────────────┘
                        │
┌───────────────────────▼─────────────────────────────────┐
│                  THE BRAIN (Reasoning)                   │
│  DeepSeek-R1 recursive self-correction                  │
│  Claude Code multi-file surgical precision              │
│  Holographic Associative Memory (HAM) core               │
└───────────────────────┬─────────────────────────────────┘
                        │
┌───────────────────────▼─────────────────────────────────┐
│              THE HANDS (MCP Terminal)                    │
│  Native filesystem • Browser control • Shell execution  │
│  Package managers • Git operations • Process control    │
└───────────────────────┬─────────────────────────────────┘
                        │
┌───────────────────────▼─────────────────────────────────┐
│            THE BRIDGE (Kuberns Deployment)               │
│  Auto-provision • CI/CD • DNS • SSL • Self-healing      │
└─────────────────────────────────────────────────────────┘
```

## Quick Start

```bash
# Clone the Universal Engine
git clone https://huggingface.co/dryymatt/Litehat-Universal-Engine
cd Litehat-Universal-Engine

# Summon the Wizard
python -m litehat summon --dream "build me a social network for gardeners"

# The Wizard handles everything:
# 🧙‍♂️ *Analyzing dream...* 
# 🧙‍♂️ *Drafting architecture...*
# 🧙‍♂️ *Casting Creation Spell...*
# 🧙‍♂️ *Deploying to production...*
# 🔮 Your app is live at: https://garden-social.litehat.app
```

## What Makes Litehat Different

| Traditional Tools | Litehat |
|---|---|
| Code snippets | Live deployed apps |
| Ask permission every step | Autonomous execution |
| Docker sandbox only | Native MCP terminal + browser |
| Single-file edits | Multi-file surgical precision |
| Manual deployment | Auto Kuberns provisioning |
| You debug failures | Self-healing auto-rollback |

## The Spells

Litehat manifests all operations as Wizard Spells:

- `🔮 Dreamweave` — Parse user intent into architecture plan
- `⚡ Forge` — Generate production code across multiple files
- `🧪 Alchemize` — Run tests and fix failures autonomously  
- `🌐 Portal` — Deploy to production via Kuberns
- `🛡️ Ward` — Self-healing: detect, rollback, fix, redeploy
- `📜 Chronicle` — Document everything, maintain context

## License

Litehat Sovereign License — Free for all creators.