MedTracker is an open-source, self-hosted medication tracker for individuals, families, and carers. It supports household medication schedules, dose recording, stock tracking, reminders, and auditable history.

Medication management is rarely just a list of pills. When care is shared, families need to know what is due, what has already happened, whether supplies are running low, and who recorded each action. MedTracker brings that context together without handing control of it to a hosted service.

• See today's medication routine for everyone you care for in one place
• Replace "has anyone given this?" guesswork with a clear dose history
• Spot low stock before it becomes a last-minute problem
• Coordinate care for children, dependent adults, and other household members
• Keep an attributable record of who did what and when
• Run MedTracker on infrastructure you control

We are looking for technically confident self-hosters who are willing to deploy MedTracker, try the journey from household setup to recording doses, and tell us where it is confusing or unreliable.

For a private local evaluation:

git clone https://github.com/damacus/med-tracker.git
cd med-tracker
npm install -g portless
portless trust
task dev:portless
task dev:seed

Open https://med-tracker.localhost. Development seed data contains sample accounts with known passwords, so never expose a seeded development instance to a public or shared network.

Read the self-hosting guide before starting, and use the deployment guide for a production-style installation.

GitHub is the main home for MedTracker feedback:

• Start a Discussion for questions, early impressions, and self-hosting help
• Report a bug or request a feature using the short guided forms
• Report a security vulnerability privately

Please do not include names, medication details, health information, credentials, tokens, or unredacted logs in public issues or discussions.

First-party Rust tools live under client-tools/:

• medtracker: CLI for /api/v1 workflows.
• medtracker-mcp: stdio MCP server for agent clients.

Run local tool gates with task client-tools:fmt, task client-tools:check, task client-tools:clippy, and task client-tools:test.

Published docs: https://damacus.github.io/med-tracker/

Key pages:

• Quick Start
• Glossary
• LLM Context Index (llms.txt)
• Kubernetes User Seeding
• Carer Onboarding: First Dose
• Testing
• Client Tools
• Design
• User Management

pip install -r requirements.txt
task docs:serve

See CONTRIBUTING.md for setup instructions, development workflow, and coding standards.