Piotr Oleszczyk
3c1dcbeb06
- Add alembic 1.14 to dependencies (uv sync → 1.18.4 installed) - Configure alembic/env.py: loads DATABASE_URL from env, imports all SQLModel models so metadata is fully populated for autogenerate - Generate initial migration (c2d626a2b36c) covering all 9 tables: products, product_inventory, medication_entries, medication_usages, lab_results, routines, routine_steps, grooming_schedule, skin_condition_snapshots — with all indexes and constraints - Add ExecStartPre to innercontext.service: runs alembic upgrade head before uvicorn starts (idempotent, safe on every restart) - Update DEPLOYMENT.md: add migration step to backend setup and update flow; document alembic stamp head for existing installations Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> |
||
|---|---|---|
| backend | ||
| docs | ||
| frontend | ||
| nginx | ||
| systemd | ||
| .gitignore | ||
| CLAUDE.md | ||
| README.md | ||
innercontext
Personal health and skincare data hub. Collects structured data (products, routines, lab results, medications, skin snapshots) and exposes it via a REST API, MCP, and a web UI to an LLM agent.
Repository layout
backend/ Python backend — FastAPI REST API + MCP server + SQLModel models
frontend/ SvelteKit web UI (Svelte 5, TypeScript, Tailwind CSS v4)
docs/ Deployment guides
nginx/ nginx config for production
systemd/ systemd service units
Backend quick start
Requirements: Python 3.12+, PostgreSQL, uv
cd backend
# Install dependencies
uv sync
# Set database URL (defaults to postgresql+psycopg://localhost/innercontext)
export DATABASE_URL=postgresql+psycopg://user:password@localhost/innercontext
# Start the API server (creates tables on first run)
uv run uvicorn main:app --reload
API docs available at http://localhost:8000/docs.
Frontend quick start
Requirements: Node.js 22+, pnpm
cd frontend
# Install dependencies
pnpm install
# Start dev server (proxies API calls to localhost:8000)
pnpm dev
UI available at http://localhost:5173.
API overview
| Prefix | Resource |
|---|---|
/products |
Skincare / medication products + inventory |
/inventory |
Individual inventory entries |
/health/medications |
Medication entries and usage history |
/health/lab-results |
Lab test results |
/routines |
AM/PM skincare routines and steps |
/routines/grooming-schedule |
Weekly grooming schedule |
/skincare |
Weekly skin condition snapshots |
/health-check |
Liveness probe |
MCP server
innercontext exposes 14 tools via FastMCP at the StreamableHTTP endpoint http://localhost:8000/mcp/mcp.
Tools include: get_products, get_product, get_open_inventory, get_recent_routines, get_latest_skin_snapshot, get_skin_history, get_medications, get_expiring_inventory, get_grooming_schedule, get_recent_lab_results, and more.
Connect an MCP-compatible LLM agent by pointing it at http://<host>/mcp/mcp.
Frontend routes
| Route | Description |
|---|---|
/ |
Dashboard |
/products |
Product list |
/products/new |
Add product |
/products/[id] |
Product detail / edit |
/routines |
Routine list |
/routines/new |
Create routine |
/routines/[id] |
Routine detail |
/health/medications |
Medications |
/health/lab-results |
Lab results |
/skin |
Skin condition snapshots |
Development
cd backend
# Lint
uv run ruff check .
# Format
uv run black .
uv run isort .
# Tests
uv run pytest
Stack
- Backend: Python 3.12, FastAPI, Uvicorn, SQLModel 0.0.37 + SQLAlchemy, Pydantic v2, PostgreSQL (psycopg3)
- MCP: FastMCP 3.0.2 (StreamableHTTP transport)
- Frontend: SvelteKit 2, Svelte 5 (Runes), TypeScript, Tailwind CSS v4, shadcn-svelte
Deployment
See docs/DEPLOYMENT.md for a step-by-step guide for a Proxmox LXC setup (Debian 13, nginx, systemd services).