इस प्रोजेक्ट के बारे में

SparkyFitness एक स्व-होस्टेड फिटनेस और स्वास्थ्य ट्रैकिंग प्लेटफ़ॉर्म है, जिसे MyFitnessPal, Flo, Hevy और Shotsy जैसे ऐप्स के गोपनीयता-प्राथमिकता वाले विकल्प के रूप में प्रस्तुत किया गया है। इसमें एक बैकएंड सर्वर (API और डेटा स्टोरेज), एक वेब फ्रंटएंड, और नेटिव iOS और Android ऐप्स शामिल हैं, और यह स्वास्थ्य डेटा को उस इन्फ्रास्ट्रक्चर पर रखता है जिसे उपयोगकर्ता नियंत्रित करता है। मुख्य ट्रैकिंग में पोषण, व्यायाम, हाइड्रेशन, नींद, उपवास, मूड और शरीर माप शामिल हैं, साथ ही लक्ष्य निर्धारण, दैनिक चेक-इन, इंटरैक्टिव चार्ट और दीर्घकालिक रिपोर्ट। यह परिवार पहुँच के साथ कई उपयोगकर्ता प्रोफ़ाइल, लाइट और डार्क थीम, और OIDC, TOTP, passkeys और MFA सहित प्रमाणीकरण विकल्पों का समर्थन करता है। सूचीबद्ध स्वास्थ्य और डिवाइस एकीकरण में Apple Health, Google Health Connect, Google Health API, Fitbit, Garmin Connect, Withings, Polar Flow, Oura, Hevy, Strava (आंशिक रूप से परीक्षित), Yazio (अनौपचारिक API), साथ ही OpenFoodFacts, USDA, Fatsecret, Nutritionix, Mealie, Tandoor, Norish, Swiss Food Database, Free Exercise DB और Wger जैसे खाद्य डेटाबेस शामिल हैं। ये कदम, वर्कआउट और नींद जैसे गतिविधि डेटा, तथा वजन और शरीर माप को सिंक करते हैं। नींद के चरण, HRV और रक्त ग्लूकोज ऐप द्वारा मापे जाने के बजाय बाहरी उपकरणों से आयात किए जाते हैं। वैकल्पिक बीटा AI सुविधाएँ (SparkyAI) भोजन, व्यायाम, शरीर आँकड़े और कदम लॉग करने के लिए संवादात्मक इंटरफ़ेस प्रदान करती हैं, जिसमें स्वचालित भोजन लॉगिंग के लिए भोजन की छवियाँ अपलोड करना भी शामिल है, और बातचीत इतिहास बनाए रखा जाता है। README में MCP सर्वर और bring-your-own-LLM समर्थन का भी उल्लेख है। इंस्टॉलेशन मुख्य रूप से Docker Compose के माध्यम से है: एक फ़ोल्डर बनाएँ, प्रोडक्शन compose फ़ाइल डाउनलोड करें, .env फ़ाइल कॉन्फ़िगर करें (ब्राउज़र-आधारित जनरेटर, न्यूनतम पाँच-मान टेम्पलेट, या पूर्ण संदर्भ की पेशकश की जाती है), डेटाबेस पासवर्ड, API एन्क्रिप्शन कुंजी, auth secret और फ्रंटएंड URL जैसे आवश्यक सीक्रेट सेट करें, फिर docker compose pull और up चलाएँ, और पोर्ट 3004 पर ऐप एक्सेस करें। गैर-तकनीकी उपयोगकर्ता तृतीय-पक्ष होस्टेड प्रदाताओं PikaPods या Zenith के माध्यम से डिप्लॉय कर सकते हैं। दस्तावेज़ीकरण, एक इंस्टॉलेशन गाइड, एक इंटरैक्टिव .env जनरेटर, सुविधा दस्तावेज़ और डेवलपर गाइड एक अलग दस्तावेज़ीकरण साइट पर होस्ट किए गए हैं, साथ में एक छोटा वीडियो ट्यूटोरियल और Discord समुदाय समर्थन है। लाइसेंसिंग स्पष्ट रूप से ओपन सोर्स के बजाय source-available है: लाइसेंस गैर-व्यावसायिक है और व्यावसायिक उपयोग के लिए अनुमति आवश्यक है। README में wger, MyFitnessPal, Cronometer, Hevy, Zero, Flo, Garmin Connect और Google Health के विरुद्ध स्वयं लिखी गई तुलना तालिका शामिल है, और नोट करता है कि तालिका परियोजना द्वारा स्वयं लिखी गई है और पुरानी हो सकती है। परियोजना सक्रिय विकास में है, चेतावनी देती है कि रिलीज़ों के बीच ब्रेकिंग बदलाव हो सकते हैं, कंटेनरों को ऑटो-अपडेट न करने की सलाह देती है, और AI चैटबॉट, परिवार और मित्र पहुँच, तथा API दस्तावेज़ीकरण को बीटा के रूप में चिह्नित करती है। अनुवाद Weblate के माध्यम से प्रबंधित किए जाते हैं।