AI-Powered Personal Fitness Platform with Gamification
Self-hosted • Privacy-first • Full control over your data
This software is NOT free for commercial use.
PersonalFit is licensed under the PolyForm Noncommercial License 1.0.0.
✅ Allowed: Personal use, learning, research, non-profit organizations ❌ Not Allowed: Commercial use, SaaS integration, reselling
For commercial licensing, contact: phillipjuanvanderberg@gmail.com
See the LICENSE file for full terms.
PersonalFit is a comprehensive, self-hosted fitness tracking application that combines AI-powered workout generation with gamification to keep you motivated. Built with a modern TypeScript stack, it offers a complete solution for tracking workouts, progress, and maintaining accountability—all while keeping your data private.
| Feature | Benefit |
|---|---|
| 🔒 Privacy-First | Your fitness data stays on YOUR server |
| 💰 No Subscriptions | Host it yourself, no monthly fees |
| 🎮 Gamification | XP, levels, streaks, 42 achievements |
| 🤖 Multi-AI Support | OpenAI, Anthropic Claude, or OpenRouter |
| 📱 Responsive | Works beautifully on desktop, tablet, mobile |
| 🛡️ Production-Ready | Rate limiting, security headers, error boundaries |
- XP & Leveling — Earn experience points for every workout completed
- 42 Achievements — Unlock badges for milestones (First Workout, Week Warrior, Century Club, etc.)
- Streak Tracking — Build daily workout streaks with freeze protection
- Daily Challenges — Fresh challenges every day for bonus XP
- Personal Records — Track PRs with automatic detection
- Gems Currency — Earn gems to purchase streak freezes
- Multi-Provider — OpenAI GPT-4, Anthropic Claude, or OpenRouter
- Personalized Plans — Based on goals, equipment, experience, injuries
- Multi-Agent Orchestration — Planner → Worker → Reviewer pipeline
- Token Management — Smart token counting and budget optimization
- Retry Logic — Exponential backoff with jitter for reliability
- Response Validation — Zod schemas ensure valid AI responses
- Visual Calendar — Week and month views
- Workout Details — Click any day for full exercise breakdown
- Progress Tracking — Completed vs planned at a glance
- Missed Workout Detection — Automated accountability
- Multiple Plans — Generate and save multiple workout programs
- Active Plan System — One active plan at a time
- Plan Preview — Weekly schedule with XP forecasts
- Session Logging — Track sets, reps, weight, RPE, notes
- Body Metrics — Weight, body fat, measurements over time
- Progress Photos — Front/side/back with S3-compatible storage
- Charts & Trends — Visualize your journey with Recharts
- Equipment Inventory — Track your home gym
- Streak Penalties — Gamified consequences for missed workouts
- Makeup Workouts — Clear penalties by completing extra sessions
- Partner System — Invite accountability partners (coming soon)
- 3-Tier Rate Limiting — Auth (10/min), AI (10/hr), General (100/min)
- Helmet Security Headers — XSS, HSTS, CSP protection
- API Key Encryption — User keys encrypted at rest
- Error Boundaries — Graceful crash recovery
- Optimistic Updates — Instant UI feedback
| Technology | Purpose |
|---|---|
| Node.js 22 | Runtime |
| Express 5.1 | Web framework |
| TypeScript 5.9 | Type safety |
| MongoDB 8.x | Database |
| Mongoose 8.x | ODM |
| OpenAI SDK | AI integration |
| Anthropic SDK | Claude support |
| tiktoken | Token counting |
| Zod | Schema validation |
| Jest | Testing (170+ tests) |
| Helmet | Security headers |
| express-rate-limit | Rate limiting |
| Technology | Purpose |
|---|---|
| React 19 | UI framework |
| Vite 7 | Build tool |
| TypeScript 5.9 | Type safety |
| TailwindCSS 3 | Styling |
| TanStack Query | Server state |
| Zustand | Client state |
| React Hook Form | Form handling |
| Zod | Validation |
| Framer Motion | Animations |
| Recharts | Data visualization |
| Playwright | E2E testing |
| Technology | Purpose |
|---|---|
| Docker | Containerization |
| Docker Compose | Orchestration |
| Nginx | Reverse proxy |
| MinIO | S3-compatible storage |
- Docker & Docker Compose
- Git
- (Optional) Node.js 22+ for local development
git clone https://github.com/Poolchaos/PersonalFit.git
cd PersonalFit
# Copy environment templates
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.envbackend/.env:
NODE_ENV=development
PORT=5000
MONGODB_URI=mongodb://mongodb:27017/personalfit
JWT_SECRET=your-super-secret-jwt-key
JWT_REFRESH_SECRET=your-refresh-secret
ENCRYPTION_SECRET=your-32-char-encryption-key
CORS_ORIGIN=http://localhost:5173frontend/.env:
VITE_API_URL=http://localhost:5000docker-compose up -d| Service | URL |
|---|---|
| 🌐 Web App | http://localhost:3000 |
| 🔌 API | http://localhost:5000 |
| 🗄️ MinIO Console | http://localhost:9003 |
cd backend
npm install
npm run devcd frontend
npm install
npm run dev# Backend tests
cd backend && npm test
# Frontend E2E tests
cd frontend && npm run test:e2ePersonalFit/
├── backend/
│ ├── src/
│ │ ├── controllers/ # Route handlers
│ │ ├── models/ # Mongoose schemas
│ │ ├── routes/ # Express routes
│ │ ├── services/ # Business logic
│ │ │ └── ai/ # AI orchestration layer
│ │ ├── middleware/ # Auth, rate limiting
│ │ ├── validators/ # Request validation
│ │ └── __tests__/ # Jest tests
│ └── Dockerfile
├── frontend/
│ ├── src/
│ │ ├── pages/ # Route components
│ │ ├── components/ # Reusable UI
│ │ ├── design-system/ # Component library
│ │ ├── hooks/ # Custom React hooks
│ │ ├── api/ # API client & query keys
│ │ ├── store/ # Zustand stores
│ │ └── utils/ # Helpers & validation
│ ├── e2e/ # Playwright tests
│ └── Dockerfile
├── docs/ # Documentation
├── docker-compose.yml
└── LICENSE
Copyright (c) 2025-2026 Phillip-Juan van der Berg. All Rights Reserved.
This project is licensed under the PolyForm Noncommercial License 1.0.0.
What this means:
- ✅ You CAN use this for personal fitness tracking
- ✅ You CAN study and learn from the code
- ✅ You CAN use this at non-profit organizations
- ❌ You CANNOT use this in a commercial product
- ❌ You CANNOT sell this or offer it as a service
- ❌ You CANNOT use this within a for-profit company
If you want to use PersonalFit commercially, you need a paid license.
Contact: phillipjuanvanderberg@gmail.com
Available license tiers:
- Startup License — For companies with < $1M annual revenue
- Enterprise License — For larger organizations
- OEM License — For embedding in your products
Contributions are welcome! Please note that by contributing, you agree that your contributions will be licensed under the same PolyForm Noncommercial License.
Phillip-Juan van der Berg 📧 phillipjuanvanderberg@gmail.com
Built with ❤️ for fitness enthusiasts who value privacy