Entropy Engine MVP – Evaluation Kit

See the shape of chaos in your data stream. This one-click kit spins up:

• a test data stream generator (TCP),
• the Entropy Engine MVP (entropy level H~, slope Y, curvature Z),
• a 3D, rotatable browser view.

Quickstart (Windows/macOS/Linux)

EE MVP PoC Demo — CLI User Guide

Roadmap: We’re iterating in small, tagged releases. See docs/ROADMAP.md.

Entropy Engine MVP — TimeFund Edition

Donate time, not money. Spend 30–60 minutes to install, run, and tell us if a live Arrow of Information Entropy helps you see disorder early.

Quickstart

Pick your OS and be running in ~2 minutes.
Privacy: Offline by default. No telemetry leaves your machine unless you choose to submit results.

Windows

1. Download EE-MVP-Setup.exe from the [latest release].
2. Double-click → choose a profile (Calm/Busy/Jammy).
3. Watch the live Arrow (H~, Y, Z).
   If SmartScreen warns, click More info → Run anyway (we publish checksums in Releases).

macOS

1. Download the .dmg from the [latest release].
2. Drag the app into Applications.
3. Open it. If Gatekeeper blocks, right-click → Open once to approve.

Linux

1. chmod +x EE-MVP.AppImage && ./EE-MVP.AppImage
2. Pick a profile → watch the Arrow.

Looks flat? Try --viz-y-gain 1.8 --viz-z-gain 2.2.
Stutters? Try --fps 20 or use the built-in Replay.

---

Prefer running from source? (fallback)

git clone https://github.com/henry-pozzetta/entropy-engine-starter-kit.git
cd entropy-engine-starter-kit
# python run-demo.py   
# or: ./run-demo.sh   (Linux/macOS)   
# or: ./run-demo.ps1  (Windows)


### What you’ll see (10 sec)
- **X:** normalized entropy \( \tilde H \)  
- **Y:** slope \( d\tilde H/dt \)  
- **Z:** curvature \( d^2\tilde H/dt^2 \)  
- **Color:** volatility intensity

### Share results (30 sec)
- Click **Generate evaluation.jsonl** in the app, then post it in **[Discussions → Results](https://github.com/OWNER/REPO/discussions/new?category=results)**  
- Or fill the short web form (link)

**Roadmap:** [docs/ROADMAP.md](docs/ROADMAP.md) • **Changelog:** [CHANGELOG.md](CHANGELOG.md) • **Troubleshooting:** [docs/troubleshooting.md](docs/troubleshooting.md)  
**Code of Conduct:** [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) • **Security:** [SECURITY.md](SECURITY.md)

## Table of Contents
- [Quickstart](#quickstart)


[latest release]: https://github.com/henry-pozzetta/entropy-engine-starter-kit/releases/latest
[Releases]: https://github.com/henry-pozzetta/entropy-engine-starter-kit/releases
[Discussions → Results]: https://github.com/henry-pozzetta/entropy-engine-starter-kit/discussions