deliveryday-companion
A Tesla delivery-day acceptance companion. Runs in your phone's browser. Works offline. Walks you through a 36-step pre-acceptance inspection (VIN match, paint, panel gaps, every screen feature, every camera, FSD trial, Supercharger handshake, drive feel) with a photo per step, then emits a signed PDF "acceptance report" you can email yourself and your delivery specialist.
Why now
You get one shot at delivery. The MVPA is signed inside an hour, and any defect not captured in writing before that signature evaporates into "service appointment" land. Cell coverage at delivery centers is often awful, so the companion is fully offline-first: SQLite-on-disk, no CDN assets, no telemetry, no outbound HTTP from the request handlers.
30-second demo
pip install deliveryday-companion
deliveryday demo
Opens at http://127.0.0.1:8002/ with a sample inspection seeded so you can click around before your VIN arrives.
Real use
deliveryday serve --port 8002
# then open the URL on your phone over your laptop hotspot, or run on the phone directly via Pythonista / Termux.
- Start a session, paste your VIN
- Walk the car category by category (VIN/Match -> Exterior -> Interior -> Functional -> Drive -> Final)
- Mark each step PASS / NOTE / FAIL, attach a photo where the checklist asks for one
- Hit "Sign & finalize", download the PDF
- Email the PDF to yourself and to your delivery specialist before you sign the MVPA
Checklist breakdown
| Category | Steps |
|---|---|
| VIN/Match | 5 |
| Exterior | 8 |
| Interior | 6 |
| Functional | 10 |
| Drive | 4 |
| Final | 3 |
| Total | 36 |
The full list lives in src/deliveryday_companion/checklist.py — edit it before delivery to match your trim, paint, and any car-specific things you care about. Run deliveryday steps to print it as a table.
What's in the PDF
- Header: VIN, location, started timestamp, session ID
- Summary table per category (PASS / NOTE / FAIL / pending counts)
- Per-step result with status pill, description, your note, and embedded photo
- Final-page signature block with date line
ReportLab over WeasyPrint specifically so a fresh uv sync Just Works on Windows without GTK/cairo runtime DLLs.
Roadmap to v0.2
- Offline PWA wrapper — service-worker manifest so iPhone Safari "Add to Home Screen" gives a real app icon and a fully offline first-launch
- Photo annotation — circle-and-arrow drawing on the captured photo for "this exact spot has the chip" precision (canvas-based, no upload)
- VIN decoder — paste a VIN, the companion auto-fills trim / paint / interior so the build-config step is a one-tap visual confirm instead of a checklist
- Compose with hey-nabu's offline scaffold — share the service worker registration code rather than duplicating it
- Re-export to JSON — let
teslakit's long-term ownership dashboard import the report as the day-zero baseline
Stack
Python 3.12+, FastAPI, Jinja2, ReportLab, SQLModel, Typer. No JavaScript framework — vanilla HTML forms, dark-themed CSS lifted from sentrytriage. MIT licensed.
Metadata
Release files for deliveryday-companion 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| deliveryday_companion-0.1.0.tar.gz | 83.9 kB | Without provenance | Details for deliveryday_companion-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| deliveryday_companion-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for deliveryday_companion-0.1.0-py3-none-any.whl |
Total release size: 106.7 kB
Release files / deliveryday_companion-0.1.0.tar.gz
| Download URL | deliveryday_companion-0.1.0.tar.gz |
|---|---|
| Size | 83.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c9f4c2533a638626cf7b954c5dbe27504e8a88b5c98069df14e6e68b1d78fc05
|
|
BLAKE2b-256 checksum How to use checksums |
4d6876a101ebf68af9d74c5ba57ccaeec131b9fa58d22ca211a4d230d03d4e2e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.12 {"installer":{"name":"uv","version":"0.11.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / deliveryday_companion-0.1.0-py3-none-any.whl
| Download URL | deliveryday_companion-0.1.0-py3-none-any.whl |
|---|---|
| Size | 22.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
96f47fea12fb4b1e85c327bb53031f8c8b3b5eb7b7962e1636197ff8f2274edb
|
|
BLAKE2b-256 checksum How to use checksums |
fb88de166c98bd3823d73c966788f3522d9f3afc0d10dc81e4f95f55ad10e3ab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.12 {"installer":{"name":"uv","version":"0.11.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for deliveryday-companion 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.