README
HypnoTrack
A SaaS platform that generates personalized hypnosis audio tracks for behavior change. You tell it what you want to work on — sleep, anxiety, quitting smoking, building confidence — and it builds you a custom hypnosis session from scratch, using AI to write the script and ElevenLabs to voice it.
The whole thing is personalized: your name woven into the audio, your specific triggers addressed, your preferred relaxation style guiding the session structure. Not a generic recording. Something made specifically for you.

The App
A fully working React MVP. Users pick a goal, answer personalization questions, choose a therapist persona, customize the voice and session length, then generate and listen.

Each therapist persona brings a genuinely different approach — distinct induction methods, pacing, signature phrases, and specializations. Sarah Mitchell focuses on mindfulness and breath work. James takes a structured CBT approach. The persona you choose shapes the entire session.

The personalization flow lets you go shallow (4 questions, 2 minutes) or deep (15 questions, 8 minutes). After answering, you fine-tune the voice, preview the full AI-generated script, and generate the audio.

See the User Guide for a complete walkthrough of every screen.
Research
Every product decision traces back to one of sixteen research documents — covering hypnosis science, CBT integration, architecture, pricing, TTS providers, UX flows, adaptive feedback, and more. Each one is interactive and browsable as a standalone web page.

| Document | What it covers |
|---|---|
| Hypnosis Research | Track structure, behavior change categories, script patterns, ethical guidelines |
| CBT Integration | How cognitive behavioral therapy combines with hypnosis for 70% better outcomes |
| Architecture | Server-side audio processing at scale — TTS + music + effects into polished audio |
| Pricing | Competitor teardown (Headspace, Calm, BetterHelp), freemium model, conversion benchmarks |
| TTS Providers | 8 options evaluated for hypnosis suitability — ElevenLabs won on quality |
| UX Flows | Issue-first vs therapist-first onboarding, backed by competitor analysis |
| Adaptive Feedback | The feedback loop that makes sessions improve over time |
| AI Models | Claude vs GPT for script generation — quality, cost, clinical accuracy |


See Research & Documentation for the full breakdown with screenshots of every document.
Presentations
Four interactive presentations communicate the project to different audiences.
AI Therapy Debate — A 17-slide pitch deck with two speakers debating AI's role in mental health. Full audio narration, synced subtitles, and visual data storytelling. Builds from the access gap (77M Europeans need help) through the cost barrier to a proposed hybrid model.

Hypnotherapy Guide — Six interconnected educational pages covering what hypnotherapy is, what CBT is, the neuroscience of trance, script structure, research evidence, and the history from Mesmer to modern practice.

App Guide — Product marketing page with features, pricing, the adaptive feedback loop, and available courses.

Architecture
| Layer | Stack |
|---|---|
| Frontend | React 19, TypeScript, Vite, Tailwind CSS, shadcn/ui |
| Backend | Go 1.22, GraphQL (gqlgen), Chi Router |
| AI/Audio | OpenAI (script generation), ElevenLabs (TTS), ffmpeg (audio mixing) |
Getting Started
# Set up environment
cp backend/.env.example backend/.env # Add OPENAI_API_KEY, ELEVENLABS_API_KEY
cp mvp/.env.example mvp/.env # Add VITE_OPENAI_API_KEY
# Run everything
./dev-all.sh
| Service | URL |
|---|---|
| React frontend | http://localhost:5173 |
| Go backend (GraphQL) | http://localhost:9090/graphql |
| Research brief | http://localhost:9000 |
| Presentations | http://localhost:8000 |
# Or run individually
cd mvp && npm install && npm run dev
cd backend && make dev
cd brief && python serve.py
cd presentation && python serve.py
Documentation
| Doc | Description |
|---|---|
| User Guide | Complete walkthrough of every app screen, with screenshots |
| Research & Docs | All sixteen research documents explained, with screenshots |
| CLAUDE.md | Project spec — decisions, architecture, track structure, API costs |
Project Structure
mockup-hypnose/
|-- mvp/ # React frontend (11 pages, 6 themes, persona system)
|-- backend/ # Go GraphQL API (hexagonal architecture)
|-- brief/ # Research archive (16 interactive HTML documents)
|-- presentation/ # Presentations (debate, guide, app guide, research hub)
|-- docs/ # Screenshots, user guide, research overview
+-- CLAUDE.md # Project spec
Related Repositories
ai-dev-presentations — Interactive presentations exploring AI-assisted development workflows, including The Test Floor (a Black Mirror-inspired narrative episode), Thronglets (Severance-style character-driven presentation), and story-format explorations that push presentations beyond slides.
Disclaimer
HypnoTrack is designed for relaxation and personal development. It is not a substitute for professional medical advice, diagnosis, or treatment. If you are experiencing serious mental health issues, please contact a qualified healthcare provider.