No description
Schema enforcement already prevents LLM from returning fields outside the defined response_schema (_SingleStepOut, _BatchStepOut). Explicit field bans (dose, amount, quantity, application_amount) are redundant and add unnecessary token cost. Removed: - 'KRYTYCZNE' warning about schema violations - 'ZABRONIONE POLA' explicit field list - 4-line 'ABSOLUTNIE ZABRONIONE' dose prohibition section Token savings: ~80 tokens per prompt (system instruction overhead) Trust the schema - cleaner prompts, same enforcement. |
||
|---|---|---|
| backend | ||
| docs | ||
| frontend | ||
| nginx | ||
| systemd | ||
| .gitignore | ||
| AGENTS.md | ||
| deploy.sh | ||
| PHASE1_COMPLETE.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 and a web UI to an LLM agent.
Repository layout
backend/ Python backend — FastAPI REST API + 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 24 LTS+, 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 |
/profile |
User profile (birth date, sex at birth) |
/health-check |
Liveness probe |
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 |
/profile |
User profile |
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)
- 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).