루틴 계획, 세트 기록, 데이터 자체 보관을 지원하는 셀프 호스팅 헬스장·체중 기록 앱입니다.
CodeWithCJ/SparkyFitness
음식, 운동, 수분 섭취, 수면 및 신체 지표를 기록하고 가족 프로필과 기기 동기화를 지원하는 셀프 호스팅 피트니스·건강 트래커입니다.
대체할 수 있는 제품:MyFitnessPal
Cronometer
Hevy
- 스타
- 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
프로젝트 폴더를 만드세요
mkdir sparkyfitness && cd sparkyfitness - 2
docker-compose.yml을 다운로드하세요
curl -L -o docker-compose.yml https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/docker-compose.prod.yml - 3
.env 파일에 안전한 키를 입력하세요(env generator를 사용하거나 자리표시자를 바꾸세요)
- 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 통계는 매일 갱신됩니다.
관련 프로젝트
Django 기반의 셀프 호스팅 오픈소스 운동·영양·체중 트래커로, REST API와 모바일 앱을 제공합니다.
여러 웨어러블 데이터 제공업체의 건강 데이터를 하나의 정규화된 API로 통합하고, 웹훅과 AI 도구용 MCP 서버를 제공하는 셀프 호스팅 플랫폼입니다.
계정 없이 휴대폰에 식단 기록을 저장하는 Android 및 iOS용 무료 오픈소스 칼로리·매크로 추적 앱입니다.
책·시리즈·게임과 운동 기록을 관리하고, 데이터를 직접 운영하는 서버에 보관하는 셀프 호스팅 트래커입니다.
Strava, Garmin Connect 및 GPX/TCX/FIT 파일의 활동을 동기화·분석하고 데이터를 자체 서버에 보관하는 셀프 호스팅 피트니스 트래킹 서비스입니다.