Update README with how to run and develop

This commit is contained in:
iamdoubz committed 2026-11-05 16:08:44 -06:00
1 parent 4359cabb87
commit 54e972add9
1 file changed
+26 -2
+26 -2
View File
@@ -2,8 +2,32 @@
Scan a paper calendar (school, lunch menu, sports, activities), review the parsed events, and export an `.ics` file or a subscribed feed for Apple and Google Calendar.
Self-hosted only: runs directly with Python or as a Docker image, with SQLite as the backend.
Self-hosted only: runs directly with Python or as a Docker image, with SQLite as the backend. The page is read by a vision model on your own Ollama server (or, optionally, Claude).
- [Product & technical spec](docs/SPEC.md)
Status: spec stage. Phase 0 (prove extraction on real calendars) is next.
Status: Phase 1 (MVP for one household) in progress.
## Run it
Copy `.env.example` to `.env` and set at least `PUBLIC_URL` and `OLLAMA_URL`.
**Plain Python** (Python 3.11+, and Node only to build the front end):
```
cd frontend && npm ci && npm run build && cd ..
pip install -r requirements.txt
python main.py
```
Then open http://127.0.0.1:8000. Rebuild the front end after changing anything in `frontend/`.
**Docker:** copy `compose.example.yml` to `compose.yml`, then `docker compose up -d --build`.
**Backups:** `python main.py backup <folder>` copies the database (safely, while running) and the photos. Schedule it nightly.
## Develop
- `cd frontend && npm run dev` serves the front end with hot reload and proxies `/api` to `python main.py`.
- Tests: `python tests/test_phase1.py`, `python -m parentcalendar.ics`, `python -m parentcalendar.extraction --selftest`.
- Extraction quality (Phase 0): `python phase0/extract.py`, then `python phase0/score.py private/runs/<run>`. The golden set lives in `private/`, outside git.