Skip to main content

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.
  1. Start a session, paste your VIN
  2. Walk the car category by category (VIN/Match -> Exterior -> Interior -> Functional -> Drive -> Final)
  3. Mark each step PASS / NOTE / FAIL, attach a photo where the checklist asks for one
  4. Hit "Sign & finalize", download the PDF
  5. 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)

Source distribution for deliveryday-companion 0.1.0
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)

Table of built distributions (wheels) for deliveryday-companion 0.1.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page