このプロジェクトについて

SparkyFitnessは、MyFitnessPal、Flo、Hevy、Shotsyなどのアプリに代わる、プライバシー優先のセルフホスト型フィットネス・健康追跡プラットフォームです。バックエンドサーバー(APIとデータストレージ)、Webフロントエンド、ネイティブの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、血糖値は、アプリで測定するのではなく、外部デバイスからインポートされます。 オプションのベータ版AI機能(SparkyAI)は、食品、運動、身体統計、歩数のログ記録のための会話型インターフェースを提供し、食品画像のアップロードによる自動食事ログ記録や、会話履歴の保持も含みます。READMEにはMCPサーバーとBYO-LLM(独自LLM持ち込み)サポートについても言及されています。 インストールは主にDocker Composeを使用します。フォルダを作成し、本番用composeファイルをダウンロードし、.envファイルを設定(ブラウザベースのジェネレーター、最小限の5値テンプレート、または完全なリファレンスが提供されます)し、データベースパスワード、API暗号化キー、認証シークレット、フロントエンドURLなどの必要なシークレットを設定してから、docker compose pullとupを実行し、ポート3004でアプリにアクセスします。技術に詳しくないユーザーは、サードパーティのホスティングプロバイダーであるPikaPodsまたはZenithを通じてデプロイできます。ドキュメント、インストールガイド、インタラクティブな.envジェネレーター、機能ドキュメント、開発者ガイドは別のドキュメントサイトでホストされており、短いビデオチュートリアルとDiscordコミュニティサポートもあります。 ライセンスは明示的にソースアベイラブルであり、オープンソースではありません。ライセンスは非商用で、商用利用には許可が必要です。READMEには、wger、MyFitnessPal、Cronometer、Hevy、Zero、Flo、Garmin Connect、Google Healthとの比較表が含まれていますが、この表はプロジェクト自身が作成したものであり、古くなっている可能性があると注記されています。 このプロジェクトは活発に開発中であり、リリース間で破壊的な変更が発生する可能性があると警告し、コンテナの自動更新を避けるようアドバイスし、AIチャットボット、家族・友人アクセス、APIドキュメントをベータ版と位置付けています。翻訳はWeblateを通じて管理されています。