convez.ai
PluginDados & AnalyticsIntermediário
Extelligence-ai

Bagel - Chat com Dados de Robótica e IoT

Extelligence-ai/bagel

Converse com seus sensores e logs robóticos em linguagem natural

Ver no GitHub
BomPluginScore · de 0 a 100

Plugin que permite conversar em linguagem natural com dados de robôs, drones e dispositivos IoT. Utiliza LLM para traduzir perguntas em SQL determinístico contra dados capturados em ROS, PX4 e outros formatos industriais, sem cálculos black-box. Ideal para análise exploratória e debugging de sistemas físicos sem necessidade de expertise em banco de dados.

Instalação

$npx convez-ai Extelligence-ai/bagel

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
407
Forks
31
Acompanhando
9
Saúde
62%
Último commit
há 2 dias
Versão
v2.5.2
Issues abertas
29
Contribuidores
5

Casos de uso

  • Análise de telemetria de drones e robôs em linguagem natural
  • Debugging de anomalias em sistemas embarcados (overheating, aceleração anômala)
  • Exploração ad-hoc de dados ROS e PX4 sem escrever queries SQL

Veredito

Bagel resolve um nicho específico e relevante: tornar acessível a análise de dados de sistemas físicos complexos. A abordagem de SQL determinístico sobre Arrow é tecnicamente sólida, mas sua utilidade depende do suporte a formatos e a qualidade das integrações com ROS/PX4—pontos ainda em expansão ('Coming soon').

README

A tradução para o português deste README ainda está na fila.

Unlike cat videos, most data are trapped in the physical world. Bagel unlocks them and lets you chat with your physical data—just like you do with ChatGPT. For example:

Is my IMU sensor overheating?

Can’t wait to try it out? 👉 Check out the Quickstart.

🥯 Key Features

  • Ask in plain language: No deep domain expertise needed.
  • Transparent calculations: Deterministic SQL queries. No black-box LLM math.
  • Broad LLM support: Claude Code, Gemini, Cursor, Codex, and more.
  • Dockerized environments: No local dependencies required.
  • Extensible capabilities: Bagel can learn new tricks.
  • Wide format coverage: Missing your data format? Open a ticket.

✅ Supported Data Formats

IndustryFormats
RoboticsROS1, ROS2
DronesPX4, ArduPilot, Betaflight
IoTComing soon...

💬 What Can I Prompt?

You can ask Bagel almost anything. For example:

What’s the correlation between current and voltage in the /spot/status/battery_states topic?

I think the robot hit a pothole. Can you check for sudden deceleration on the z-axis to confirm?

Can you help me tune the PID of my drone?

Time to put Bagel to the test: can it catch a drone doing barrel rolls? Spoiler: 🎉 It totally can.

💡 How Bagel Works

When you ask a question, Bagel analyzes your data source’s metadata and topics to build a high-level understanding.

Based on your prompt, if further inspection is needed, Bagel identifies the most relevant topics and interprets their meaning and structure. Bagel then writes the relevant topic messages to an Apache Arrow file and uses DuckDB to generate and execute queries against it.

This process is repeated as needed, running new queries until Bagel finds the best answer to your question.

LLMs excel at language but struggle with math. Bagel overcomes this by generating deterministic DuckDB SQL queries. These queries are displayed for you to audit, and you can guide Bagel to correct any errors.

⚡️ Quickstart

Three commands. That’s it.

[!TIP] Already have Claude Code? Just paste the link to this repo and tell Claude what environment you want:

Set up https://github.com/Extelligence-ai/bagel for ROS2 Kilted.

Claude will clone the repo, start Docker, and wire up the MCP connection for you.

📋 Prerequisites

Install Docker Desktop and Claude Code (or another MCP-enabled LLM).

1. Clone and start Bagel

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

Pick the service that matches your environment:

ServiceUse case
ros2-kiltedROS2 Kilted (latest)
ros2-jazzyROS2 Jazzy
ros2-ironROS2 Iron
ros2-humbleROS2 Humble
ros1-noeticROS1 Noetic
ros1-noetic-cvROS1 Noetic + CV
px4PX4 flight logs
ardupilotArduPilot flight logs
betaflightBetaflight flight logs

[!TIP] To give Bagel access to your local files, edit compose.yaml before starting Docker: uncomment and update the volumes section under your chosen service.

Wait for this output:

INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)

2. Connect Claude Code

In a new terminal:

claude mcp add --transport sse bagel http://0.0.0.0:8000/sse

3. Prompt

claude

Summarize the metadata of the ROS2 bag "./data/sample/ros2/mcap".

That’s it — you’re chatting with your data.

Bagel works with any MCP-enabled LLM. Setup runbooks for tested alternatives:

Can’t find your LLM? Open a ticket.

🐶 Teach Bagel a New Trick

Bagel learns new capabilities through POML files—a structured set of instructions that describe a “trick,” such as computing latency statistics.

✍️ Create a .poml file

For example, let’s define ./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, the topic count, and a few cute emojis. Nothing else.
    </output-format>
</poml>

🗣️ Use the capability

Prompt Bagel:

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

Result:

meow 🐱 4 topics 🐱💤🎯

📦 Integrations

  • Cloudini — Decode cloudini-compressed pointcloud data in pipelines

🫶 Contributing

We’d love your help! The easiest way to support the project is by giving it a ⭐ on GitHub.

Other great ways to contribute:

  • Request new features
  • Report bugs
  • Improve documentation
  • Add new capabilities

Before contributing, please review the guidelines.

Join the conversation in our Discord server — we hang out there regularly.

📄 License

Bagel is open source under the Apache License 2.0.

Ver o original no GitHub

Bom para

Relacionados