Healthium is a full-stack web application designed to make nutrition more accessible, practical, and actionable, even for people with busy daily routines.
Instead of requiring strict planning or deep nutritional knowledge, Healthium helps users make smarter food decisions instantly through AI-powered tools and real-world context.
🚀 Built in 48 hours during the BugsByte Hackathon 2026 (taikai.network) 🏆 3rd Place Winner 💰 €400 Prize
Healthium Demo – BugsByte 2026
The core goal of Healthium is simple:
Make healthy eating easier - even when your routine doesn’t allow it.
Healthium reduces friction in everyday decisions like:
- “What should I eat?”
- “Is this healthy?”
- “Is there a better option nearby?”
By combining AI, user data, and real-time context, the platform delivers fast, personalized insights.
Compare the nutritional profile of two products instantly to make better decisions.
Find restaurants and food spots near you with healthier nutritional options.
Upgrade a meal or product into a healthier version while keeping its essence.
Swap a dish for an alternative with similar nutritional values, preserving balance while improving choice.
Scan ingredients (e.g. your fridge) and generate healthy recipes automatically.
Scan a restaurant menu and instantly identify the healthiest meal available.
Interact with an AI assistant for real-time nutrition guidance and recommendations.
Generate structured reports with personalized nutritional insights and recommendations.
healthium/
├── bones/ # Backend - FastAPI
│ ├── app/
│ │ ├── helpers/ # AI wrappers & utility functions
│ │ ├── router/ # API endpoints
│ │ ├── database.py # SQLAlchemy engine & session
│ │ ├── main.py # App entry point
│ │ ├── models.py # SQLModel database models
│ │ └── schemas.py # Pydantic data validation
│ ├── .env # Private credentials (not committed)
│ └── pyproject.toml # Dependencies (managed with uv)
│
└── skin/ # Frontend - Vue 3 + TypeScript
├── src/
│ ├── api/ # Axios + TanStack Query logic
│ ├── assets/ # Images & styles
│ ├── components/ # Reusable UI components
│ ├── lib/ # Utility libraries (e.g. shadcn)
│ ├── router/ # Routes & navigation guards
│ ├── stores/ # Pinia state management
│ ├── views/ # Main pages
│ ├── App.vue # Root component
│ ├── main.ts # Frontend entry point
│ └── style.css # Global styles (Tailwind)
└── index.html # SPA entry point-
bones/ Handles backend logic, API endpoints, AI integrations, and database persistence.
-
skin/ Handles the user interface, state management, and communication with the backend.
- FastAPI
- SQLite
- OpenAI API (GPT-4o)
- fpdf
- Vue 3
- TypeScript
- Vite
- Pinia
- TanStack Query
- Tailwind CSS v4
You will need two terminal instances.
cd bones
uv sync
uv run uvicorn app.main:app --reloadcd skin
bun install
bun run devCreate a .env file inside bones/:
OPEN_AI_KEYS=""
FAT_SECRET_CLIENT_ID=""
FAT_SECRET_KEY=""
GOOGLE_API_KEY=""Healthium tackles a real problem:
- People want to eat better
- But time, convenience, and lack of information get in the way
This project bridges that gap by:
- Turning complex nutrition into simple decisions
- Using AI to reduce effort
- Integrating directly into everyday scenarios (restaurants, groceries, home cooking)
Developed during a 48-hour hackathon sprint at UMinho: