Home Service AIOS

Family Service OS MVP (FastAPI + SQLite/SQLModel). See AGENTS.md for agent constraints.

Local checks

scripts/run_checks.sh

How To Demo

Start the API:

python -m uvicorn app.main:app --reload

Then open another terminal and request the demo summary:

curl http://127.0.0.1:8000/today-summary

Or run the local demo script without starting a server:

scripts/demo_today_summary.sh

Cursor Hooks (optional)

Project hook: after the agent Writes a *.py file under the workspace, Cursor runs:

.cursor/hooks/run_pytest_after_edit.py

• Runs pytest tests -q --tb=no --no-header from the repo root (prefers .venv Python).
• Always fail-open (exit 0) so edits are not blocked.
• On failure, a short summary is printed to stderr (view in Cursor Output → Hooks).

Configuration lives in .cursor/hooks.json. Override interpreter with env AIOS_HOOK_PYTHON if needed.

Reload hooks after editing JSON (save hooks.json or restart Cursor).