عن المشروع

SparkyFitness هو منصة لتتبع اللياقة البدنية والصحة ذاتية الاستضافة، وتُقدم كبديل يركز على الخصوصية لتطبيقات مثل MyFitnessPal وFlo وHevy وShotsy. يتكون من خادم خلفي (API بالإضافة إلى تخزين البيانات)، وواجهة ويب أمامية، وتطبيقات أصلية لنظامي iOS وAndroid، ويُبقي بيانات الصحة على البنية التحتية التي يتحكم فيها المستخدم. يغطي التتبع الأساسي التغذية والتمارين والترطيب والنوم والصيام والمزاج وقياسات الجسم، إلى جانب تحديد الأهداف والفحوصات اليومية والرسوم البيانية التفاعلية والتقارير طويلة الأجل. يدعم ملفات تعريف متعددة للمستخدمين مع وصول عائلي، وسمات فاتحة وداكنة، وخيارات مصادقة تشمل OIDC وTOTP ومفاتيح المرور و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 وسكر الدم من الأجهزة الخارجية بدلاً من قياسها بواسطة التطبيق. توفر ميزات الذكاء الاصطناعي الاختيارية في الإصدار التجريبي (SparkyAI) واجهة محادثة لتسجيل الطعام والتمارين وإحصائيات الجسم والخطوات، بما في ذلك تحميل صور الطعام لتسجيل الوجبات تلقائيًا، مع الاحتفاظ بسجل المحادثة. يذكر ملف README أيضًا خادم MCP ودعم إحضار نموذج اللغة الخاص بك (BYO-LLM). يتم التثبيت بشكل أساسي عبر Docker Compose: إنشاء مجلد، وتنزيل ملف compose للإنتاج، وتكوين ملف .env (يتم تقديم مولّد قائم على المتصفح، أو قالب بسيط من خمس قيم، أو مرجع كامل)، وتعيين الأسرار المطلوبة مثل كلمة مرور قاعدة البيانات ومفتاح تشفير API وسر المصادقة وعنوان URL للواجهة الأمامية، ثم تشغيل docker compose pull و up، والوصول إلى التطبيق على المنفذ 3004. يمكن للمستخدمين غير التقنيين النشر من خلال موفري الاستضافة الخارجيين PikaPods أو Zenith. يتم استضافة الوثائق ودليل التثبيت ومولّد .env التفاعلي ووثائق الميزات وأدلة المطورين على موقع وثائق منفصل، مع برنامج تعليمي فيديو قصير ودعم مجتمع Discord. الترخيص متاح المصدر بشكل صريح وليس مفتوح المصدر: الترخيص غير تجاري ويتطلب إذنًا للاستخدام التجاري. يتضمن ملف README جدول مقارنة من تأليف المشروع نفسه ضد wger وMyFitnessPal وCronometer وHevy وZero وFlo وGarmin Connect وGoogle Health، ويشير إلى أن الجدول كتبه المشروع نفسه وقد يكون قديمًا. المشروع قيد التطوير النشط، ويحذر من أن التغييرات الجذرية قد تحدث بين الإصدارات، وينصح بعدم التحديث التلقائي للحاويات، ويضع علامة تجريبية على روبوت الدردشة الذكي ووصول العائلة والأصدقاء ووثائق API. تتم إدارة الترجمات عبر Weblate.