SparkyFitness
Samohostowana, zorientowana na prywatność alternatywa dla MyFitnessPal. Śledź odżywianie, ćwiczenia, parametry ciała i dane zdrowotne, zachowując pełną kontrolę nad swoimi danymi.

SparkyFitness to samohostowana platforma do śledzenia postępów fitness, składająca się z:
- Serwera backendowego (API + przechowywanie danych)
- Frontendu opartego na przeglądarce internetowej
- Natywne aplikacje mobilne na iOS i Androida
Kluczowe funkcje
- Śledzenie odżywiania, ćwiczeń, nawodnienia, snu, postów, nastroju i pomiarów ciała
- Ustalanie celów i codzienne odprawy
- Interaktywne wykresy i długoterminowe raporty
- Wiele profili użytkowników i dostęp dla rodziny
- Motywy jasny i ciemny
- OIDC, TOTP, Passkey, MFA itd.
Integracje zdrowotne i sprzętowe
SparkyFitness może synchronizować dane z wielu platform zdrowotnych i fitness:
- Apple Health (iOS)
- Google Health Connect (Android)
- Fitbit
- Garmin Connect
- Withings
- Polar Flow (częściowo przetestowane)
- Hevy (nieprzetestowane)
- OpenFoodFacts
- USDA
- Fatsecret
- Nutritioninx
- Mealie
- Tandoor
- Strava (częściowo przetestowane)
Opcjonalne funkcje AI (Beta)
SparkyAI udostępnia interfejs konwersacyjny do rejestrowania danych i przeglądania postępów.
- Rejestruj jedzenie, ćwiczenia, statystyki ciała i kroki przez czat
- Przesyłaj zdjęcia posiłków do automatycznego logowania posiłków
- Zachowuje historię rozmów do dalszych działań
Szybki start (Serwer)
Uruchom serwer SparkyFitness w kilka minut za pomocą Docker Compose.
# 1. Create a new folder
mkdir sparkyfitness && cd sparkyfitness2. 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.example3. (Optional) Edit .env to customize database credentials, ports, etc.
4. Start the app
docker compose pull && docker compose up -dAccess application at http://localhost:8080
🎥 Samouczek wideo
Szybki 2-minutowy samouczek pokazujący jak zainstalować SparkyFitness (samohostowany tracker fitness).
Dokumentacja
Pełne przewodniki instalacji, opcje konfiguracji i dokumentację dla deweloperów znajdziesz na naszej Stronie Dokumentacji.
Szybkie linki
- Przewodnik instalacji - Wdrożenie i konfiguracje
- Przegląd funkcji - Pełna dokumentacja funkcji
- Przepływ pracy deweloperskiej - Przewodnik dla dewelopera i proces kontrybucji
- Informacje o aplikacji iOS oraz Informacje o aplikacji Android
Potrzebujesz pomocy?
- Zamieść pytanie w issues/dyskusji Github.
- Aby uzyskać szybszą odpowiedź i pomoc od innych członków społeczności Dołącz do naszego Discorda
Historia gwiazdek
Tłumaczenia
Aktywność repozytorium
Współtwórcy
⚠️ Znane problemy / Funkcje beta ⚠️
SparkyFitness jest w fazie aktywnego rozwoju. Zmiany łamiące kompatybilność mogą wystąpić pomiędzy wydaniami.
- Automatyczna aktualizacja kontenerów nie jest zalecana
- Zawsze zapoznaj się z informacjami o wydaniu przed aktualizacją
- AI Chatbot
- Dostęp dla rodziny i znajomych
- Dokumentacja API
