Об этом проекте

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 и уровень глюкозы в крови импортируются с внешних устройств, а не измеряются приложением. Опциональные бета-функции ИИ (SparkyAI) предоставляют разговорный интерфейс для записи еды, упражнений, показателей тела и шагов, включая загрузку изображений еды для автоматической записи приёмов пищи, с сохранением истории разговоров. В README также упоминаются сервер MCP и поддержка собственной LLM (bring-your-own-LLM). Установка в основном выполняется через Docker Compose: создайте папку, скачайте production-файл compose, настройте файл .env (предлагаются браузерный генератор, минимальный шаблон из пяти значений или полный справочник), задайте необходимые секреты, такие как пароль базы данных, ключ шифрования API, секрет аутентификации и URL фронтенда, затем выполните docker compose pull и up, после чего приложение будет доступно на порту 3004. Нетехнические пользователи могут развернуть приложение через сторонних хостинг-провайдеров PikaPods или Zenith. Документация, руководство по установке, интерактивный генератор .env, документация по функциям и руководства для разработчиков размещены на отдельном сайте документации, также доступны короткий видеоурок и поддержка сообщества в Discord. Лицензирование явно является source-available, а не open source: лицензия некоммерческая и требует разрешения для коммерческого использования. README включает составленную самим проектом сравнительную таблицу с wger, MyFitnessPal, Cronometer, Hevy, Zero, Flo, Garmin Connect и Google Health и отмечает, что таблица написана самим проектом и может быть устаревшей. Проект активно развивается, предупреждает о возможных ломающих изменениях между релизами, не рекомендует автоматически обновлять контейнеры и помечает ИИ-чатбота, доступ для семьи и друзей, а также документацию API как бета-функции. Переводы управляются через Weblate.