HexMind Public Demo

HexMind is a multi-persona decision demo built around a V3 Six Thinking Hats flow. This repository is a public demo export, not a mirror of the hosted private product.

It keeps the parts that are useful for open demos:

• a runnable deterministic V3 discussion engine
• sample personas and sample hat prompts
• a lightweight demo API and CLI
• a small React demo UI
• public screenshots and sharing assets

It deliberately excludes:

• billing and payment code
• production deployment files
• hosted authentication and webhook code
• private prompt libraries
• commercial strategy, pricing, and internal operating docs
• real user data, archives, logs, and environment files

Quick Start

python -m pip install -e ".[dev]"
hexmind personas
hexmind prompts
hexmind discuss "Should a small team introduce an AI decision-review workflow?"

The public demo uses deterministic canned output, so it does not need API keys.

Run The Demo API

uvicorn hexmind.api.app:app --reload

Then open:

• http://127.0.0.1:8000/api/health
• http://127.0.0.1:8000/api/personas
• http://127.0.0.1:8000/api/prompts

Run The Demo UI

cd web
npm install
npm run dev

The UI can call the local demo API. If the API is not running, it falls back to sample output so the repository still works as a static showcase.

Repository Layout

src/hexmind/          public demo engine, CLI, API, models, events
web/                  lightweight React demo UI
personas/             public sample personas
prompts/library/      public sample hat and role prompts
docs/public/          screenshots and public boundary docs
tests/                smoke tests for the public demo export

Public Boundary

See docs/public/open-source-boundary.md for the public/private split. The export is produced by scripts/prepare_public_repo.py from the private workspace using an allowlist.

License

MIT