Kleinkram - Open Robotic Data Management

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.

Documentation

For full documentation, please visit docs.datasets.leggedrobotics.com.

Try Kleinkram Locally

You can easily run a local instance of Kleinkram to try it out. This has been tested on Ubuntu 24.04 and macOS.

1. Clone the repository

git clone [email protected]:leggedrobotics/kleinkram.git
cd kleinkram

2. Start the application

docker compose up --build

Why --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.

3. 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.

4. 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

Start Developing

For a deeper dive into the project structure and development workflow, see the Application Structure documentation. Your development environment is designed for Ubuntu 24.04.