dryymatt's picture
Upload README.md
6afe4df verified
# 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.