tiny-pilot / tiny-pilot/tinypilot
Provide canonical dev setup
Open
@jotaen4tinypilot is already working on this.
Since Jan 20, 2026.
enhancement
- Dominant language
- Python
- Stars
- 3.5k
- Forks
- 291
- PR merge metrics
- No merged PRs in 30d
Description
Setting up a local instance of the TinyPilot web server can be tricky, because the backend has specific requirements regarding the environment – e.g.:
- On device, it runs on Raspberry Pi OS, which is a specialized flavor of Debian
- Certain system packages need to be installed
- The application makes certain assumptions about the executing user or system paths
Without intimate knowledge of these requirements, it can be challenging to bootstrap a dev environment that is fully (mostly) working.
One idea here would be to provide a tailored Docker image, which mimics the device environment closely.
This may also simplify some of our development procedures, such as running the Playwright end-to-end tests.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.