Documentation

Everything needed to go from clone to first answer. Bagel's documentation lives beside the code in the repository, so you can consult the tag or commit matching your installed version.

Choose a task

Analyze MCAP and ROS bagsInspect topics and schemas, query a time window, and show the SQL behind each finding.Reduce logs around incidentsWatch a real MCAP reduction, download the synthetic sample, and reproduce the kept window.Investigate PX4 flight-log anomaliesRun the bundled ULog checks, then inspect the data behind voltage drops and sensor changes.

Compact documentation index · Share a reproducible workflow

Installation

Bagel ships one container per ecosystem. Requirements: Docker Desktop, Python 3.10+ if running natively, and an MCP-enabled client.

To give Bagel access to your recordings, uncomment and edit the volumes section under your chosen service in compose.yaml.

terminal

git clone https://github.com/Extelligence-ai/bagel.git && cd bagel
docker compose run --service-ports ros2-kilted

# then, in a new terminal
claude mcp add --transport sse bagel http://localhost:8000/sse

# The 0.0.0.0 in that log is the container's listen address. Connect using localhost.

Compose services

ros2-kiltedROS 2 Kilted (latest)

ros2-jazzyROS 2 Jazzy

ros2-ironROS 2 Iron

ros2-humbleROS 2 Humble

ros1-noeticROS 1 Noetic

ros1-noetic-cvROS 1 Noetic + CV

px4PX4 flight logs

ardupilotArduPilot flight logs

betaflightBetaflight flight logs

iotIoT / MQTT (live)

Client setup

Claude CodeDetailed guide

Local LLM (Ollama)Fully offline

↗

Using something else? Open a ticket.

Guides and runbooks

Natural-language pipelines↗

Cadence, gates and tasks. Preview, run, save, batch, then leave it standing at the edge.

Event-driven data reduction↗

Detect events, keep windows around them as snippets or one reduced bag, batch across fleets.

Live ROS 2 robots over rosbridge↗

Step-by-step tutorial for querying a running robot rather than a recording.

ROS text logs↗

Inspect errors and warnings in ~/.ros/log. Tracebacks stay attached.

MQTT↗

Live IoT topics, Sparkplug B decoding and edge recording.

PostgreSQL / TimescaleDB↗

Every table becomes a topic, so joins and correlations are one question.

InfluxDB 3↗

Every measurement becomes a topic.

Automotive MDF4 & CAN (beta)↗

Channel groups and DBC messages are topics; units ride along with the signal.

Extending Bagel

Capabilities are declared in POML files: a structured set of instructions describing a task and its output format. Drop one in src/agent/, then ask Bagel to run it against any data source.

This is the lowest-friction way to contribute: no Python required, and the capability works across every supported format.

src/agent/examples/woof.poml

<poml>
<task>
Count the topics in the data source.
If the count is odd, say "woof", else say "meow".
</task>
<output-format>
Return the sound and the topic count. Nothing else.
</output-format>
</poml>

prompt

Run the POML capability "./src/agent/examples/woof.poml"
on the ROS2 bag "./data/sample/ros2/mcap".

Integrations

RerunAny time window as a ready-to-open recording.↗Lichtblick / FoxgloveEvent windows as MCAP plus pre-framed layouts.↗PlotJugglerOne-sentence pre-framed sessions, flattened CSV/Parquet exports.↗CloudiniDecode cloudini-compressed pointcloud data inside pipelines.↗SlackPipelines post to your ops channel when they fire.↗LeRobot (beta)Detected events become a LeRobotDataset v3.0 of training episodes.↗

Missing an integration? Open a ticket.

Browse the repository ↗