Repolode
CodeWithCJ

CodeWithCJ/SparkyFitness

음식, 운동, 수분 섭취, 수면 및 신체 지표를 기록하고 가족 프로필과 기기 동기화를 지원하는 셀프 호스팅 피트니스·건강 트래커입니다.

대체할 수 있는 제품:MyFitnessPalCronometerHevy

스타
6,462
포크
436
열린 이슈
186
마지막 커밋
4시간 전

어떤 프로젝트인가요?

SparkyFitness는 백엔드 API와 데이터 저장소, 웹 프런트엔드, iOS 및 Android 네이티브 앱으로 구성된 셀프 호스팅 피트니스 트래킹 플랫폼입니다. 건강 데이터는 타사 서비스가 아니라 사용자가 직접 관리하는 인프라에 저장됩니다.

영양, 운동, 수분 섭취, 수면, 단식, 기분 및 신체 치수를 기록할 수 있으며, 목표 설정, 일일 체크인, 대화형 차트와 장기 보고서를 제공합니다. 여러 사용자 프로필과 가족 단위 액세스를 지원하고, OIDC, TOTP, passkey 및 MFA 로그인 옵션도 제공됩니다.

Apple Health, Health Connect, Fitbit, Garmin Connect, Withings, Oura 등의 서비스에서 걸음 수, 운동 기록, 수면 및 체중을 가져올 수 있으며, OpenFoodFacts와 USDA 같은 데이터베이스에서 식품 정보를 조회할 수 있습니다. 선택 사항인 베타 AI 어시스턴트를 사용하면 채팅이나 음식 사진으로 식사와 활동을 기록할 수 있습니다.

핵심 기능

  • 01영양, 운동, 수분 섭취, 수면, 단식, 기분 및 신체 치수를 기록합니다.
  • 02Apple Health, Fitbit, Garmin Connect 등의 웨어러블 및 건강 플랫폼에서 데이터를 동기화합니다.
  • 03여러 사용자 프로필과 가족 단위 액세스를 지원합니다.
  • 04OIDC, TOTP, passkey 및 MFA 로그인을 지원합니다.
  • 05대화형 차트와 장기 보고서를 제공합니다.
  • 06데이터 기록을 위한 선택 사항인 베타 AI 채팅 기능을 제공합니다.

활용 사례

  • 유료 구독 없이 가족의 식단과 운동 기록을 관리합니다.
  • 홈 서버나 프라이빗 클라우드에서 개인 건강 데이터를 호스팅합니다.
  • 여러 웨어러블 기기와 식품 데이터베이스의 데이터를 한곳에 모읍니다.

빠른 시작

  1. 1

    프로젝트 폴더를 만드세요

    mkdir sparkyfitness && cd sparkyfitness
  2. 2

    docker-compose.yml을 다운로드하세요

    curl -L -o docker-compose.yml https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/docker-compose.prod.yml
  3. 3

    .env 파일에 안전한 키를 입력하세요(env generator를 사용하거나 자리표시자를 바꾸세요)

  4. 4

    앱을 시작하고 http://localhost:3004 에서 여세요

    docker compose pull && docker compose up -d

사용 전 알아둘 점

  • SparkyFitness는 오픈 소스가 아닌 소스 공개 소프트웨어이며, 상업적 이용에 허가가 필요한 비상업용 라이선스가 적용됩니다.
  • 릴리스 간 호환성을 깨는 변경이 발생할 수 있으며, 컨테이너 자동 업데이트는 권장되지 않습니다.
  • AI 기능, 가족 액세스 및 API 문서는 베타 버전으로, 버그가 있을 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

SparkyFitness은(는) 무엇인가요?
음식, 운동, 수분 섭취, 수면 및 신체 지표를 기록하고 가족 프로필과 기기 동기화를 지원하는 셀프 호스팅 피트니스·건강 트래커입니다. SparkyFitness는 백엔드 API와 데이터 저장소, 웹 프런트엔드, iOS 및 Android 네이티브 앱으로 구성된 셀프 호스팅 피트니스 트래킹 플랫폼입니다. 건강 데이터는 타사 서비스가 아니라 사용자가 직접 관리하는 인프라에 저장됩니다.
SparkyFitness은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
SparkyFitness은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
SparkyFitness은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. SparkyFitness의 마지막 커밋은 2026년 10월 24일입니다.
SparkyFitness은(는) 어디에 사용할 수 있나요?
유료 구독 없이 가족의 식단과 운동 기록을 관리합니다. 홈 서버나 프라이빗 클라우드에서 개인 건강 데이터를 호스팅합니다. 여러 웨어러블 기기와 식품 데이터베이스의 데이터를 한곳에 모읍니다.
SparkyFitness는 어떻게 설치하나요?
프로젝트 폴더를 만드세요: mkdir sparkyfitness && cd sparkyfitness docker-compose.yml을 다운로드하세요: curl -L -o docker-compose.yml https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/docker-compose.prod.yml .env 파일에 안전한 키를 입력하세요(env generator를 사용하거나 자리표시자를 바꾸세요) 앱을 시작하고 http://localhost:3004 에서 여세요: docker compose pull && docker compose up -d
SparkyFitness은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/CodeWithCJ/SparkyFitness

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트