How shreyastaware/ai_fitness_coach works
This repository presents an AI fitness coach landing page and a Python backend for a phone-based coaching agent. The documented user journey is an inbound phone call, speech transcription, personalized AI response with retrieved fitness knowledge and conversation context, then spoken audio returned to the caller. The frontend advertises plans, features and a local demo; the README describes backend integrations more fully than the sampled source establishes. Backend flow edges therefore reflect documented architecture, not verified implementation details.
Main entry points: App.tsx Page Composer · server.py AI Agent Backend · app Fitness Advice · Header.tsx Navigation
Components 22
Product Website
- Page Composer
Frontend/src/App.tsx - Navigation
Frontend/src/components/Header.tsx - Landing Hero
Frontend/src/components/Hero.tsx - How It Works
Frontend/src/components/HowItWorks.tsx - Feature Catalog
Frontend/src/components/Features.tsx - Interactive Demo
Frontend/src/components/Demo.tsx - Testimonials
Frontend/src/components/Testimonials.tsx - Plans and Pricing
Frontend/src/components/Pricing.tsx - Trial Contact Form
Frontend/src/components/Contact.tsx - Site Footer
Frontend/src/components/Footer.tsx
Voice Experience
- Phone Caller
- Twilio Voice
- AI Agent Backend
app/server.py - Speech Recognition
- Speech Synthesis
- Call Utility
app/callNow.py
Coaching Intelligence
- Fitness Advice
app - Knowledge Retrieval
app - Conversation Context
app - Language Model
- Vector Store
Other components
- Prospective User
Connections 21
- Page Composer → Navigation: renders
Frontend/src/App.tsx - Page Composer → Landing Hero: renders
Frontend/src/App.tsx - Page Composer → How It Works: renders
Frontend/src/App.tsx - Page Composer → Feature Catalog: renders
Frontend/src/App.tsx - Page Composer → Interactive Demo: renders
Frontend/src/App.tsx - Page Composer → Testimonials: renders
Frontend/src/App.tsx - Page Composer → Plans and Pricing: renders
Frontend/src/App.tsx - Page Composer → Trial Contact Form: renders
Frontend/src/App.tsx - Page Composer → Site Footer: renders
Frontend/src/App.tsx - Prospective User → Page Composer: views
- Phone Caller → Twilio Voice: places call
README.md - Twilio Voice → AI Agent Backend: sends audio
README.md - AI Agent Backend → Speech Recognition: transcribes speech
README.md - AI Agent Backend → Fitness Advice: requests advice
README.md - Fitness Advice → Knowledge Retrieval: retrieves knowledge
README.md - Knowledge Retrieval → Vector Store: queries
README.md - Fitness Advice → Conversation Context: maintains context
README.md - Fitness Advice → Language Model: generates response
README.md - AI Agent Backend → Speech Synthesis: synthesizes response
README.md - Speech Synthesis → Twilio Voice: returns audio
README.md - Twilio Voice → Phone Caller: plays audio
README.md