Project Info
Staying healthy doesn’t have to feel like a daily battle. HealthChain goes beyond the standard fitness and nutrition apps. It’s not just another diet plan or workout routine—it's your dedicated partner, powered by the latest emotional intelligence technology, designed to help you stay on track, even when life tries to pull you away from your goals. Emotionally Responsive AI: Like a Friend Who Really Gets You Unlike typical AI trainers that just dish out cookie-cutter advice, HealthChain uses emotional AI to tune into your feelings and motivations. Imagine having a coach who knows when you’re feeling unmotivated or stressed and provides the right encouragement at the perfect moment. It senses when you’re struggling and adapts your training plan accordingly, keeping you engaged, uplifted, and less likely to fall off the wagon. This human-like touch means that you’re not just following a diet plan—you’re building a new lifestyle, with genuine support that meets you where you are. No More Generic Advice—Get Personalized Feedback That Actually Works HealthChain dives deep into your unique habits, tendencies, and goals to provide hyper-personalized feedback. The AI learns what triggers your cravings, what times of day you’re most motivated, and even the moments when you’re likely to slip up. By creating a plan tailored specifically for you, it helps break down your bigger health goals into manageable milestones and celebrates every win along the way—no matter how small. Stay Accountable Without the Guilt We all know what it’s like to cheat on a diet or miss a workout and feel the guilt afterward. HealthChain doesn’t believe in guilt trips. Instead, it uses emotionally intelligent responses to help you acknowledge setbacks and move past them quickly, keeping your focus on progress rather than perfection. It learns from your experiences to adjust future plans in ways that make your goals feel achievable again. Powered by Hume.ai Technology for Deeper Motivation HealthChain’s integration with Hume.ai enables it to assess your emotional state through every interaction, from tracking your food intake to post-workout check-ins. It understands the why behind your actions, which lets it go beyond just being a trainer—HealthChain becomes the emotional ally that helps you stay committed to your health journey. Why HealthChain? Emotionally Intelligent: Goes beyond the numbers and workouts to connect with you on a deeper level. Real-Time Adaptation: Recognizes when you're at risk of falling off track and provides the right nudge. Celebrates Milestones: Keeps you motivated by acknowledging your progress. Non-Judgmental Support: Helps you recover from setbacks with understanding, not guilt. Join HealthChain and redefine what’s possible with a personal trainer that understands not just your fitness goals, but you. Staying healthy doesn’t have to feel like a daily battle anymore. Our Journey with HealthChain: Building a Personal AI Trainer🗺️
Inspiration
✨ The inspiration for HealthChain came from our belief that staying healthy doesn’t have to feel like a daily battle. We wanted to create a solution that transcends traditional fitness apps by offering real emotional support and personalized guidance. What It Does🔍 HealthChain is your dedicated AI personal trainer, powered by Hume.ai emotional intelligence technology. It adapts to your feelings and motivations, providing personalized fitness and nutrition plans with the help of Google Gemini's parsing and structured data features. Unlike typical AI trainers that offer generic advice, HealthChain understands when you're unmotivated or stressed, offering timely encouragement to keep you on track.
How we built it
👷🏼♀️ We built HealthChain by integrating with Hume.ai EVI 2's emotional analysis capabilities. This allows the platform to assess users' emotional states and requests in real time and adjust dietary plans and goals accordingly. .
Challenges we ran into
🔨 This was some our team's first time ever working with AI so the learning curve of how to utilize the best parts of the various AIs we used and how to make them work together was one of our biggest challenge. We also needed to address privacy concerns surrounding emotional data, ensuring users felt secure while using the app. One last major challenge was deployment, where we had to assets the differences between running locally with Vercel and online with AWS and how to essentially fix all the bugs associated with deployment
Accomplishments we're proud of
⭐ We are proud to have created a platform that truly understands users as individuals. HealthChain not only helps users achieve their fitness goals but also celebrates every milestone, fostering a positive and supportive experience. These accomplishments encompass learning how to extract and parse data outputs Gemini and Hume as well as tailoring and personalizing our Hume AI.
What we learned
📖 We learned a lot about new and innovative AI models and how to effectively chain, prompt, and extract meaningful data with large language models to accomplish our goals. We also were able to gain a better understanding on how user's emotions and experiences can translate to greater motivation and commitment. Outside of our technical discoveries, we also learned a lot about each other, as this is the first time we've ever met and worked together.
What's next
🔮 Our goal is to continue evolving the platform to offer even deeper insights and support, making health and wellness accessible and enjoyable for everyone. Features we hope to implement in the future would be the ability for user to specifically tailor their AI trainer's personality, a calendar feature that allows users to easily choose a date and view what and when they ate, a great mobile interface and wearable technologies for better accessibility and convenience, and allowing users to submit feedback on our FAQ section.

HealthChain
Overview
HealthChain is your dedicated AI personal trainer, powered by Hume.ai emotional intelligence technology. It adapts to your feelings and motivations, providing personalized fitness and nutrition plans with the help of Google Gemini's parsing and structured data features. Unlike typical AI trainers that offer generic advice, HealthChain understands when you're unmotivated or stressed, offering timely encouragement to keep you on track.
Authors and Acknowledgment
HealthChain was created by Addy, Derek, Joshua, and Steven,.
Project Local Run Instructions
npm install
npm run dev
.env Setup
Make sure to create a .env file and fill it with the stuff from discord
HUME_API_KEY=
HUME_SECRET_KEY=
NEXT_PUBLIC_HUME_CONFIG_ID=
GEMINI_API_KEY=
Project deployment
Click the button below to deploy this example project with Vercel:
Below are the steps to completing deployment:
- Create a Git Repository for your project.
- Provide the required environment variables. To get your API key and Client Secret key, log into the portal and visit the API keys page.
Deployment Bug Commands
# if node version if out of date
nvm install node
corepack enable pnpm
pnpm install
# or
pnpm install --no-frozen-lockfile
Support
If you have questions, require assistance, or wish to engage in discussions pertaining to this starter template, please reach out to us on Discord.
Setting Up the Backend
To set up the backend, follow these steps:
- Create a Virtual Environment:
python3 -m venv venv
- Activate the Virtual Environment:
- On macOS and Linux:
source venv/bin/activate - On Windows:
.\venv\Scripts\activate
- Navigate to the Backend Source Directory:
cd backend/src
- Install dependencies
pip install -r requirements.txt
- Run the Backend Application:
python main.py
This will start the backend server, and it should be running and ready to handle requests.
Analysis
View
Metric
- 40
- 39
- 39
- 3
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- CSSIn code
- FastAPIIn code
- FlaskIn code
- HTMLIn code
- JavaScriptIn code
- LangChainIn code
- Next.jsIn code
- OllamaIn code
- PythonIn code
- ReactIn code
- Tailwind CSSIn code
- TypeScriptIn code
- Google GeminiClaimed
- Node.jsClaimed
- VercelClaimed
12 of 15 appear in the indexed code. 3 claimed on Devpost could not be matched to code, which may simply mean the tool leaves no trace in the repository.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
263 KB
Source files
62
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
addychen2/healthchain
90 files · 3.8 MB · @ 8286245
Structure
Interface
45 files · 50%Screens, components and styles rendered to the user.
+4 moreApplication logic
16 files · 18%Domain rules, services and shared utilities.
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here — open the file browser to check anything the diagram implies.
Languages
- YAML54%
- TypeScript27%
- Python12%
- JavaScript4%
- Markdown1%
- CSS1%
- Other (1)0%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
backend/src/requirements.txt
pypi · 130- aiohappyeyeballs
- aiohttp
- aiosignal
- annotated-types
- anyio
- asgiref
- attrs
- backoff
- bcrypt
- blinker
- build
- cachetools
- certifi
- charset-normalizer
- chroma-hnswlib
- chromadb
- click
- coloredlogs
- +112 more
package.json
npm · 37- @humeai/voice-react
- @radix-ui/react-slot
- @radix-ui/react-switch
- @radix-ui/react-toggle
- @types/react-virtualized
- chart.js
- chromadb
- class-variance-authority
- clsx
- framer-motion
- geist
- hume
- js-cookie
- langchain
- lucide-react
- next
- node
- pnpm
- +19 more
Declared in the repository’s manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
This project’s features have not been analysed yet.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.