Bit-Bots Software Stack

This git repository contains all RoboCup-related code and documentation from the Hamburg Bit-Bots team. All code is written as individual ROS 2 packages.

Installation

The workspace is managed using the pixi package manager. This allows us to have reproducible builds and easy user space dependency management similar to tools like uv or cargo. This also means that no system wide ROS installation or superuser privileges are required to install or run the code.

Full step-by-step instructions for installing the Bit-Bots software stack and ROS 2 can be found in our documentation here.

Run the following command inside this repository to build the workspace. All dependencies will be installed automatically. Make sure you have pixi installed. A few optional proprietary dependencies will be needed for full functionality, see the documentation for details.

pixi run build

Using the workspace

To activate the workspace run the following command in the terminal you want to use:

pixi shell

alternatively, you can run individual commands inside the workspace without activating the shell:

pixi run <command>

To see some predefined / commands, run

pixi task list

Deploy to robots

To deploy the software to a robot, run

pixi run deploy <robot_ip|robot_name>

For more information on the deployment tooling, see this documentation.

Run auto formatting

To format all code in the repository, run

pixi run format

More documentation

Our documentation is hosted on docs.bit-bots.de.