Welcome to Pulse 🥑

Pulse is a comprehensive AI-powered health and nutrition platform that revolutionizes personal wellness through advanced analysis of genomic, epigenomic, and lifestyle data to deliver personalized immunity enhancement strategies.

🏆 Pulse was developed within 36 hours for Samartha National Level Hackathon 2025 🎉

🌿 Intelligent health guidance made simple with cutting-edge AI technology and personalized nutrition recommendations.

• React 19.2.0 with TypeScript
• Vite
• Tailwind CSS 4.x
• Framer Motion
• React Router DOM
• React Markdown
• Axios
• Groq SDK (AI Integration)
• Supabase (Database)
• Recharts (Data Visualization)
• Lucide React (Icons)
• React Icons
• React Is
• Remark GFM (GitHub Flavored Markdown)

• Groq API with OpenAI GPT-OSS-20B model
• Dual Agent System (Analyzer + Coach Agents)
• Image Analysis (Food scanning and nutrition analysis)
• Personalized Health Recommendations
• Voice Integration
• Custom AI Prompts
• Real-time Streaming Responses
• Hardware Connection using Google Fit

• Dual Agent Health Coaching System 🤖
  • Advanced Analyzer Agent for health data synthesis using Groq
  • Professional Coach Agent for personalized health advice
  • Context-aware recommendations considering all health constraints
  • Real-time health guidance with transparent thinking process
• AI-Powered Image Query of Food 🔍
  • Advanced meal image analysis using AI model
  • Comprehensive nutrition breakdown with calories, macros, and micronutrients
  • Health verdict and immunity impact analysis
  • Dietary tag identification and allergen detection
  • Personalized recommendations based on user profile
• Intake & Diet Management 🥤
  • Real-time tracking of daily nutrition and hydration
  • Calorie goal management aligned with immunity goals
  • Personalized recipe suggestions based on user profile
  • Integration with tracker for automatic logging
• Intelligent Coach System 💬
  • Single chat interface with dual-agent power
  • Context auto-updates after every interaction
  • Image attachment capabilities for meal analysis
  • Conversational health guidance with professional tone
• Comprehensive Health Tracking 📊
  • Daily tracking of meals, hydration, sleep, exercise
  • Symptom monitoring and stress tracking
  • Exercise logging with duration and type tracking
  • Photo documentation for meal tracking
• Smart Diet Planning 🍽️
  • Detailed food and water intake tracking
  • Nutritional analysis with JSONB storage
  • Meal timing preferences and pattern recognition
  • Calorie and nutrient optimization
• Behavioral Pattern Adaptation 🧠
  • Habit tracking with calorie burn estimation
  • Daily, weekly, and monthly habit scheduling
  • Completion tracking and progress analytics
  • Adaptive recommendations based on behavior patterns
• Personalized Reminders ⏰
  • One-time reminders with specific dates/times
  • Medication and supplement scheduling
  • Health task management
  • Completion status tracking
• Chat History & Context 💭
  • Recent chat storage and retrieval system
  • Conversation grouping and organization
  • Context continuity across sessions
  • Searchable conversation history
• Comprehensive Dashboard 📋
  • Unified health metrics visualization
  • Weekly meal planning interface
  • Water and workout tracking visualization
  • Calendar view for health metrics over time
  • Immunity index calculation and tracking
• Advanced Health Analytics 📈
  • Pattern recognition in dietary habits
  • Immunity score calculation from multiple factors
  • Historical trend analysis
  • Predictive health insights
• Responsive Design 📱
• Secure Authentication 🔐
• Error Handling 🛡️
• Smooth Animations 🌈
• Intuitive UI/UX Design 🎨
• @ Mention System 📌
  • Context-aware data retrieval with @profile, @health, @today, @meals, @habits, @reminders
  • Smart auto-detection of required health data
  • Seamless integration with dual agent system

1. Clone this repository:

   git clone https://github.com/ayuxy027/pulse.git

2. Navigate to project directory:

   cd pulse

3. Install dependencies:

   npm install

4. Create a .env file in the root directory with the following variables:

   VITE_SUPABASE_URL=your_supabase_url_here
   VITE_SUPABASE_ANON_KEY=your_supabase_anon_key_here
   VITE_GROQ_API_KEY=your_groq_api_key_here
   VITE_GEMINI_API_KEY=your_gemini_api_key_here  # Optional for image analysis

5. Start the development server:

   npm run dev

Contributions are welcomed! 😁
Let's keep the spirit of open source alive!

• Please follow the project's license terms before redistributing or modifying.
• Creating something from scratch takes a lot of hard work, and I hope you respect that. 😄
• If you have any questions or need permission for something specific, feel free to reach out.

If you have any inquiries or suggestions, please reach out:

• Email: [email protected]
• X (Twitter): ayuxy027
• GitHub: ayuxy027