🏃 Health & Wellness Tracker Bot

🇺🇦 Українська версія

Telegram Web App for tracking calories, physical activity, and mood with FatSecret and WHOOP API integration.

📋 Description

The system allows you to:

• 🎤 Log food via voice messages
• 🍎 Automatically determine calorie content (FatSecret API)
• 💪 Sync workout data from WHOOP
• 📊 Receive daily reports on calorie balance
• 😊 Keep a mood and wellness journal

🏗 Architecture

Telegram Bot → FastAPI (Python) → APIs (FatSecret, WHOOP, OpenAI) → PostgreSQL

📁 Project Structure

health-tracker/
├── app/                  # FastAPI Python application
│   ├── routers/          # API route handlers
│   ├── services/         # Business logic
│   ├── main.py           # App entrypoint
│   └── scheduler.py      # Periodic jobs
├── .github/specs/        # GitHub Spec Kit specifications
├── docs/                 # Bilingual documentation (uk/en)
├── database/migrations/  # SQL migrations
├── CLAUDE.md             # AI assistant instructions
├── README.md             # This file
└── README.uk.md          # Ukrainian README

🚀 Quick Start

Prerequisites

• Python 3.12+
• PostgreSQL 15+
• API keys: Telegram, FatSecret, WHOOP, OpenAI

Setup

1. Clone the repository
2. Create .env file with credentials
3. Run database migrations
4. Start the app: uvicorn app.main:app

📖 Documentation

• Getting Started
• API Integration
• Architecture
• Design Specs

🔗 External APIs

API	Purpose	Documentation
FatSecret	Food calories	Docs
WHOOP	Workout data	Docs
OpenAI Whisper	Speech-to-Text	Docs
Telegram Bot API	User interface	Docs

📄 License

MIT

---

Created: January 2026