SparkyFitness
SparkyFitness: Built for Families. Powered by AI. Track food, fitness, water, and health — together.
What is it?
What it is
SparkyFitness is a self-hosted, privacy-first fitness tracking platform that allows users to log nutrition, exercise, body metrics, sleep, hydration, fasting, mood, and more while retaining full control of their health data.
Why it exists
It exists to provide a self-hosted alternative to commercial fitness apps like MyFitnessPal, ensuring data privacy and ownership by letting users run the platform on their own infrastructure.
Who should use it
Teams building with TypeScript who want an open-source, self-hosted option.
Who should avoid it
Teams that need a fully managed SaaS with enterprise SLAs out of the box.
How it works
A quick walkthrough in plain English
How SparkyFitness works in 4 steps
Step 1 of 4
Something triggers the flow
A schedule, webhook, or manual click tells SparkyFitness to start.
Features
Advantages
- Full control over personal health data
- Open source and community‑driven
- Supports a wide range of device and platform integrations
- Built‑in multi‑factor authentication and passkey support
- Family and multi‑user access
- AI‑powered conversational logging (beta)
- Easy deployment via Docker Compose
- Cross‑platform (web, iOS, Android)
- Light/dark theme customization
- Extensive nutrition database integrations
- Active development and frequent updates
- Multilingual interface
Disadvantages
- AI chatbot and some integrations are still in beta and may contain bugs
- Active development can lead to breaking changes between releases
- Requires technical knowledge for self‑hosting and Docker setup
- Limited official API documentation
- Some integrations (e.g., Hevy, Strava) are not fully tested
- Potential performance issues on low‑resource servers
- No native desktop application
- User interface may lack polish compared to commercial alternatives
Installation
compose
# 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
FAQ
How do I install SparkyFitness using Docker Compose?
Create a folder, download the latest docker-compose.prod.yml and default.env.example files, optionally edit .env for custom settings, then run `docker compose pull && docker compose up -d`. The app will be accessible at http://localhost:8080.
Which health and fitness platforms can SparkyFitness sync with?
SparkyFitness integrates with Apple Health, Google Health Connect, Google Health API, Fitbit, Garmin Connect, Withings, Polar Flow, Hevy, OpenFoodFacts, USDA, Fatsecret, Nutritionix, Mealie, Tandoor, Strava, Norish, Yazio, Swiss Food Database, Free Exercise DB, and Wger.
Are the AI features (SparkyAI) ready for production use?
The AI features are currently in beta. They allow logging food, exercise, body stats, and steps via chat, uploading food images for automatic meal logging, and retaining conversation history, but may contain bugs or incomplete functionality.
I don’t want to self-host; how can I try SparkyFitness in the cloud?
Non-technical users can deploy a hosted instance via PikaPods by clicking the ‘Run on PikaPods’ button or visiting https://www.pikapods.com/pods?run=sparkyfitness.
Where can I find detailed documentation and get help if I run into issues?
Full guides are available at the documentation site https://codewithcj.github.io/SparkyFitness/. For assistance, post in GitHub issues/discussions or join the community Discord at https://discord.gg/vcnMT5cPEA.
How should I update my SparkyFitness installation?
Always review the release notes before upgrading. Auto-updating containers is not recommended; instead, pull the latest docker-compose file and restart the services manually.
Featured in Videos
YouTube tutorials and walkthroughs for SparkyFitness
s6
1,671,961 views
Starts at 00:00
Alternatives
Similar projects ranked by category, topics, and text overlap.
