Back to Nypnose

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.

Landing Page


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.

Goals Page

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.

Therapist Selection

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.

Customize Session

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.

Research Hub

DocumentWhat it covers
Hypnosis ResearchTrack structure, behavior change categories, script patterns, ethical guidelines
CBT IntegrationHow cognitive behavioral therapy combines with hypnosis for 70% better outcomes
ArchitectureServer-side audio processing at scale — TTS + music + effects into polished audio
PricingCompetitor teardown (Headspace, Calm, BetterHelp), freemium model, conversion benchmarks
TTS Providers8 options evaluated for hypnosis suitability — ElevenLabs won on quality
UX FlowsIssue-first vs therapist-first onboarding, backed by competitor analysis
Adaptive FeedbackThe feedback loop that makes sessions improve over time
AI ModelsClaude vs GPT for script generation — quality, cost, clinical accuracy
Architecture Research

TTS Research

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.

AI Therapy Debate

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.

Hypnotherapy Guide

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

App Guide


Architecture

LayerStack
FrontendReact 19, TypeScript, Vite, Tailwind CSS, shadcn/ui
BackendGo 1.22, GraphQL (gqlgen), Chi Router
AI/AudioOpenAI (script generation), ElevenLabs (TTS), ffmpeg (audio mixing)

Getting Started

bash
# 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

ServiceURL
React frontendhttp://localhost:5173
Go backend (GraphQL)http://localhost:9090/graphql
Research briefhttp://localhost:9000
Presentationshttp://localhost:8000

bash
# 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

DocDescription
User GuideComplete walkthrough of every app screen, with screenshots
Research & DocsAll sixteen research documents explained, with screenshots
CLAUDE.mdProject spec — decisions, architecture, track structure, API costs

Project Structure

shell
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.

© 2026 Jonathan Leahy · v1.0.5-2-g88a26b5