https://github.com/codewithcj/sparkyfitness
SparkyFitness: Built for Families. Powered by AI. Track food, fitness, water, and health — together.
https://github.com/codewithcj/sparkyfitness
ai artificial-intelligence fitness fitness-app fitness-tracker health health-coaching healthcheck self-hosted selfhosted
Last synced: about 1 month ago
JSON representation
SparkyFitness: Built for Families. Powered by AI. Track food, fitness, water, and health — together.
- Host: GitHub
- URL: https://github.com/codewithcj/sparkyfitness
- Owner: CodeWithCJ
- License: other
- Created: 2025-06-21T14:00:39.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-03-03T22:26:11.000Z (2 months ago)
- Last Synced: 2026-03-04T01:42:20.312Z (2 months ago)
- Topics: ai, artificial-intelligence, fitness, fitness-app, fitness-tracker, health, health-coaching, healthcheck, self-hosted, selfhosted
- Language: TypeScript
- Homepage: https://codewithcj.github.io/SparkyFitness/
- Size: 75.5 MB
- Stars: 2,835
- Watchers: 10
- Forks: 127
- Open Issues: 41
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
🌐 Language
# SparkyFitness
A self-hosted, privacy-first alternative to MyFitnessPal. Track nutrition, exercise, body metrics, and health data while keeping full control of your data.
SparkyFitness is a self-hosted fitness tracking platform made up of:
- A backend server (API + data storage)
- A web-based frontend
- Native mobile apps for iOS and Android
It stores and manages health data on infrastructure you control, without relying on third party services.
## Core Features
- Nutrition, exercise, hydration, sleep, fasting, mood and body measurement tracking
- Goal setting and daily check-ins
- Interactive charts and long-term reports
- Multiple user profiles and family access
- Light and dark themes
- OIDC, TOTP, Passkey, MFA etc.
## Health & Device Integrations
SparkyFitness can sync data from multiple health and fitness platforms:
- **Apple Health** (iOS)
- **Google Health Connect** (Android)
- **Fitbit**
- **Garmin Connect**
- **Withings**
- **Polar Flow** (partially tested)
- **Hevy** (not tested)
- **OpenFoodFacts**
- **USDA**
- **Fatsecret**
- **Nutritioninx**
- **Mealie**
- **Tandoor**
- **Strava** (partially tested)
Integrations automatically sync activity data such as steps, workouts, and sleep, along with health metrics like weight and body measurements, to your SparkyFitness server.
## Optional AI Features (Beta)
SparkyAI provides a conversational interface for logging data and reviewing progress.
- Log food, exercise, body stats, and steps via chat
- Upload food images for automatic meal logging
- Retains conversation history for follow ups
Note: AI features are currently in beta.
## Quick Start (Server)
Get a SparkyFitness server running in minutes using Docker Compose.
```bash
# 1. Create a new folder
mkdir sparkyfitness && cd sparkyfitness
# 2. Download Docker files only
curl -L -o docker-compose.yml https://github.com/CodeWithCJ/SparkyFitness/releases/latest/download/docker-compose.prod.yml
curl -L -o .env https://github.com/CodeWithCJ/SparkyFitness/releases/latest/download/default.env.example
# 3. (Optional) Edit .env to customize database credentials, ports, etc.
# 4. Start the app
docker compose pull && docker compose up -d
# Access application at http://localhost:8080
```
## 🎥 Video Tutorial
[](https://www.youtube.com/watch?v=B13IiL2DeQc)
Quick 2-minute tutorial showing how to install SparkyFitness (self-hosted fitness tracker).
## Documentation
For full installation guides, configuration options, and development docs, please visit our [Documentation Site](https://codewithcj.github.io/SparkyFitness/).
### Quick Links
- **[Installation Guide](https://codewithcj.github.io/SparkyFitness/install/docker-compose)** - Deployment and configurations
- **[Features Overview](https://codewithcj.github.io/SparkyFitness/features)** - Complete feature documentation
- **[Development Workflow](https://codewithcj.github.io/SparkyFitness/developer/getting-started)** - Developer guide and contribution process
- **[iOS App Info](https://github.com/CodeWithCJ/SparkyFitness/wiki/Apple-Health-Integration)** and **[Android App Info](https://github.com/CodeWithCJ/SparkyFitness/wiki/Android-Mobile-App)**
### Need Help?
- Post in Github issues/discussion.
- For faster response and get help from other community memebers **[Join our Discord](https://discord.gg/vcnMT5cPEA)**
## Star History
## Translations
**[Weblate Translations](https://hosted.weblate.org/engage/sparkyfitness)**
## Repository activity
## Contributors
## ⚠️ Known Issues / Beta Features ⚠️
SparkyFitness is under active development.
Breaking changes may occur between releases.
- Auto-updating containers is not recommended
- Always review release notes before upgrading
The following features are currently in beta and may not have been thoroughly tested. Expect potential bugs or incomplete functionality:
- AI Chatbot
- Family & Friends access
- API documentation