Repository navigation
Contributing
ChristianHandy edited this page Nov 17, 2026
·
2 revisions
FleetPilot needs testers, translators, reviewers and developers. No homelab needed: the live demo and the demo lab emulate the machines.
- Test it on your hardware and report what breaks, or tell us how it went in Discussions.
- Pick a task: good first issues · help wanted · translation. Comment "I'd like to work on this" and wait to be assigned; assigned issues without activity for two weeks become free again.
- Rewrite AI-written code by hand (#201), review pull requests, or become a second maintainer (#230).
- Fork the repository and create a branch from
main. - Set up and run the checks:
pip install --require-hashes -r requirements-lock.txt -r requirements-dev-lock.txt
python -m coverage run -m pytest -q && python -m coverage report && ruff check .
- Add tests (in
tests/) and a line inCHANGELOG.mdunder Unreleased if users notice the change. - Sign off every commit:
git commit -s(DCO). - Open the pull request and fill in the template, including the AI assistance section.
| Check | Passes when |
|---|---|
| pytest (3.11, 3.12, 3.13) | Tests pass, coverage doesn't drop, at least 70 % of changed lines are tested, no vulnerable dependency |
| Safe to merge | Install-and-use test, Android build, virus and backdoor scan, ShellCheck, changelog entry, no new untranslated German text |
| AI assistance | The code is written by people: no declared AI help, no strong AI style signals, no AI leftovers |
| Analyze (python) | CodeQL finds nothing new |
A summary comment on the pull request says what fails and how to fix it. Using AI to learn or to understand the code is fine; the code you submit should be your own. Say honestly in the AI assistance section what you used: a maintainer can allow a pull request after review.
Everything in detail: CONTRIBUTING.md · Code of conduct
FleetPilot is GPL-3.0-or-later. Wiki pages summarise the documentation in the repository, which is authoritative. Found something wrong? Open an issue.
Use FleetPilot
Help build it
Links