|
1 | | -# Jumpstarter |
| 1 | +#  Jumpstarter |
2 | 2 |
|
3 | | -A Python framework and CLI tool for Hardware in the Loop automation and development. |
| 3 | +[](https://github.com/jumpstarter-dev/jumpstarter) |
| 4 | +[](https://github.com/jumpstarter-dev/jumpstarter/actions) |
| 5 | +[](https://github.com/jumpstarter-dev/jumpstarter/releases) |
| 6 | +[](https://github.com/jumpstarter-dev/jumpstarter/blob/main/packages/jumpstarter/pyproject.toml) |
| 7 | +[](https://github.com/jumpstarter-dev/jumpstarter/blob/main/LICENSE) |
| 8 | +[](https://github.com/astral-sh/uv) |
4 | 9 |
|
5 | | -For comprehensive documentation, visit [docs.jumpstarter.dev](https://docs.jumpstarter.dev) |
| 10 | +An open source and cloud native Hardware-in-the-Loop testing tool that enables you to test your software stack on both real hardware and virtual environments using CI/CD principles. |
| 11 | + |
| 12 | +## Highlights |
| 13 | + |
| 14 | +- 🚀 A single, unified testing tool for local, virtual, and remote hardware testing. |
| 15 | +- 🐍 Write test scripts in Python with familiar frameworks such as [pytest](https://docs.pytest.org/en/stable/). |
| 16 | +- 🛠️ Use [drivers](https://docs.jumpstarter.dev/introduction/drivers.html) to abstract complex hardware interfaces for testing. |
| 17 | +- 🔌 Built-in support for common interfaces such as [CAN](https://github.com/jumpstarter-dev/jumpstarter/tree/main/packages/jumpstarter-driver-can), [IP](https://github.com/jumpstarter-dev/jumpstarter/tree/main/packages/jumpstarter-driver-network), [GPIO](https://github.com/jumpstarter-dev/jumpstarter/tree/main/packages/jumpstarter-driver-raspberrypi), [U-Boot](https://github.com/jumpstarter-dev/jumpstarter/tree/main/packages/jumpstarter-driver-uboot), [SD Wire](https://github.com/jumpstarter-dev/jumpstarter/tree/main/packages/jumpstarter-driver-sdwire), etc. |
| 18 | +- 💻 Collaborate with developers around the world on shared test hardware. |
| 19 | +- ☸ Integrates with your existing [Cloud Native](https://www.cncf.io/) development environment. |
| 20 | +- 🔄 Run hardware tests with your existing CI/CD pipelines in the cloud. |
| 21 | +- 📦 Support for containerized test runners with Podman/Docker. |
| 22 | +- 🖥️ Supports Linux and macOS. |
| 23 | + |
| 24 | +## Installation |
| 25 | + |
| 26 | +Install all the Jumpstarter Python components: |
| 27 | + |
| 28 | +```console |
| 29 | +pip install --extra-index-url https://docs.jumpstarter.dev/packages/simple jumpstarter-all |
| 30 | +``` |
| 31 | + |
| 32 | +Or, just install the `jmp` CLI tool: |
| 33 | + |
| 34 | +```console |
| 35 | +pip install --extra-index-url https://docs.jumpstarter.dev/packages/simple jumpstarter-cli |
| 36 | +``` |
| 37 | + |
| 38 | +To install the [Jumpstarter Service](https://docs.jumpstarter.dev/introduction/service.html) |
| 39 | +in your Kubernetes cluster, see the [Service Installation](https://docs.jumpstarter.dev/installation/service/index.html) |
| 40 | +documentation. |
| 41 | + |
| 42 | +## Documentation |
| 43 | + |
| 44 | +Jumpstarter's documentation is available at [docs.jumpstarter.dev](https://docs.jumpstarter.dev). |
| 45 | + |
| 46 | +Additionally, the command line reference documentation can be viewed with `jmp --help`. |
| 47 | + |
| 48 | +## Contributing |
| 49 | + |
| 50 | +Jumpstarter welcomes contributors of all levels of experience and would love to |
| 51 | +see you involved in the project. See the [contributing guide](https://github.com/jumpstarter-dev/jumpstarter/blob/main/CONTRIBUTING.md) to get started. |
| 52 | + |
| 53 | +## License |
| 54 | + |
| 55 | +Jumpstarter is licensed under the Apache 2.0 License ([LICENSE](https://github.com/jumpstarter-dev/jumpstarter/blob/main/LICENSE) or [https://www.apache.org/licenses/LICENSE-2.0](https://www.apache.org/licenses/LICENSE-2.0)). |
0 commit comments