Heracles

Overview

Mobile training platform that structures programming into 12 Labors. AI generates periodized programs, adapts to injuries and schedule changes, and coaches via text and voice.

Most training apps are just workout loggers. Heracles generates periodized programs, adjusts them based on your performance data, and explains every decision through an AI training partner you can talk to mid-session. The 12 Labors framework structures training into configurable mesocycles covering hypertrophy, strength, deload, and cut phases, with AI suggesting layout changes based on fatigue markers and progression trends. The AI companion runs on Claude Sonnet 4.6 or GPT-5.4-mini and has access to 22 tools for querying your training history, modifying workouts, recommending deloads, and adapting around injuries or limited equipment. Voice coaching uses LiveKit with Deepgram STT and ElevenLabs TTS for hands-free interaction during training. The program adapts to real life: flag an injury and it swaps affected exercises, enter a cutting phase and it adjusts volume to preserve strength, travel to a hotel gym and it regenerates workouts for the equipment you have.

Category

AI

Stack

PythonFastAPILiveKitAnthropicSupabase

The XII Labors

01 Nemean Lion
02 Lernaean Hydra
03 Ceryneian Hind
04 Erymanthian Boar
05 Augean Stables
06 Stymphalian Birds
07 Cretan Bull
08 Mares of Diomedes
09 Belt of Hippolyta
10 Cattle of Geryon
11 Apples of Hesperides
12 Cerberus

Features

Program Generation

AI-driven engine generates periodized programs from split templates (PPL, Upper/Lower, Full Body). RPE-based progression with injury filtering and equipment constraints.

AI Companion

Text and voice coaching via Claude Sonnet 4.6 or GPT-5.4-mini. 22 AI tools for training queries, workout modifications, and progress analysis. SSE streaming with tool-use loop.

Voice Sessions

LiveKit-powered real-time voice with Deepgram STT and ElevenLabs TTS. Voice sessions sync to backend conversation history.

Adaptive Programming

Detects performance drift, adjusts for injuries, cutting phases, and travel. Progressive overload tracking with personal record history.

Recovery Tracking

Check-ins for sleep, stress, soreness, and readiness scoring. Body metrics with S3 photo management. Journal entries for training notes.

Exercise Library

800+ exercises seeded from free-exercise-db. Search, substitution engine, and custom exercise creation. Filtered by available equipment.

Architecture

Backend

FastAPISQLAlchemyAlembicPydanticSupabase

AI + Voice

AnthropicOpenAILiveKitDeepgramElevenLabs

Infrastructure

DockerPostgreSQLMinIO S3CaddyCoTURN