Kleinkram is a self-hosted, open-source platform for managing and processing robotics data. It provides a structured way to store, organize, and act on your data.
- Organize: Structure data in Projects and Missions.
- Store: Support for ROS bags (
.bag,.mcap), ZED camera recordings (.svo2), and configs (.yml). - Process: Run automated actions (validation, conversion, extraction) using Kleinkram Actions.
- Collaborate: Share data with granular access control.
For full documentation, please visit docs.datasets.leggedrobotics.com.
You can easily run a local instance of Kleinkram to try it out. This has been tested on Ubuntu 24.04 and macOS.
- Clone the repository
git clone git@github.com:leggedrobotics/kleinkram.git
cd kleinkram- Start the application
docker compose up --buildWhy --build?
The --build flag ensures that the Docker images are built before starting. For more details on Docker Compose, see the official docs.
Warning
If you have run Kleinkram locally before, you should consider deleting all existing data. See the Try Kleinkram Locally documentation for more details.
- Access the application
You can now access the frontend at http://localhost:8003.
Tip
Browser Compatibility Make sure to use Chrome or Firefox for the best experience with the local development server. There are some known issues related to Safari when running Kleinkram locally.
- Configure CLI (Optional)
If you want to use the CLI with your local instance, you need to set the endpoint to local:
klein endpoint local
klein login