Habita Health Coach

Getting Started

Initial Setup

cp .env.example .env

npm install

Running the Application

npm run docker:up

Philosophy & Scope

Core Philosophy

• Build healthier habits through consistent, small actions
• Focus on behavioral change and accountability
• Supportive and encouraging interactions
• Regular check-ins and progress tracking
• Iterative adjustment based on feedback

Key Features

• Initial lifestyle assessment (LLM-assisted)
• Personalized goal setting (LLM-assisted)
• Action planning and tracking (LLM-assisted)
• Regular check-ins via Telegram messages (workflow)
• Progress monitoring and adjustments (LLM-assisted)

Focus Areas

• Sleep and circadian rhythms
• Mood and stress management
• Diet and nutrition
• Movement and exercise

Technical Architecture

Core Components

1. Backend Server

   • Node.js with TypeScript
   • Background services for polling and scheduling

2. Database

   • PostgreSQL

3. External SDKs

   • Telegram Bot SDK
   • LLM SDK (e.g., Groq)

Key Libraries

• telegraf: telegraf Bot SDK
• groq-sdk: Groq SDK
• prisma: Database ORM
• node-cron: Task scheduling

Flow Diagrams

System Flow

flowchart TD
    U[User/Coachee] -->|DM| T[Telegram API]
    T -->|Poll| S[Server]
    S -->|Process| C[Conversation Manager]
    C -->|Get/Store| D[(Database)]
    C -->|Generate| L[LLM API]
    L -->|Response| C
    C -->|Reply| T
    S -->|Schedule| CH[Check-in Manager]
    CH -->|Reminder| T

Loading

Techical Specifications

See the TECH-SPEC document for implementation details.