Roboto SDK
Roboto is the analytics engine for Physical AI: ingest, search, and analyze your robotics data at scale, and put AI agents to work on it 🤖
Most robotics teams start with manual review: visualizing logs and replaying data. That approach alone doesn't scale; your fleet generates more data than your team can ever review. Roboto helps you go from raw logs to root cause 🚀 Ingest ROS 1, ROS 2, PX4, ArduPilot, Parquet, CSV, video, and journal logs (see Data Formats), query data across your fleet, define custom actions to post-process it, and let AI agents search, triage, and summarize it for you.
This package is the official Python SDK for Roboto. The roboto command line utility is distributed separately as standalone binaries (see CLI below).
If this is your first time using Roboto, start with the docs and the core concepts.
Install
- The Roboto Python SDK is available on PyPI.
- Requirements: Python 3.10+
pip install roboto
Then sign in:
- Sign up at app.roboto.ai.
- Sign in through your browser:
python -m roboto.cli auth login
The command opens the Roboto web app. Check that the page shows the confirmation code printed in your terminal, then click Approve. Over SSH, or on Linux without a display, the command opens no browser. Instead, open the URL it prints on any device, approve the sign-in there, and paste the authorization code the page shows into your terminal.
The command saves the new access token to ~/.roboto/config.json, in the file's default profile. If that profile already exists, the command stops before signing you in unless you add --overwrite, which replaces the profile's token.
- Check that you're signed in:
python -m roboto.cli users whoami
Where nobody can approve a sign-in in a browser, such as in a CI job, create an access token in the web app instead, as Programmatic Access describes.
See the complete SDK documentation.
To rule out both, confirm your Python version meets the requirement:
python3 -c "import sys; assert sys.version_info >= (3, 10), f'Python 3.10+ required, found {sys.version}'"
Create and activate a virtual environment:
# macOS/Linux
python3 -m venv .venv && source .venv/bin/activate
# Windows
python -m venv .venv && .venv\Scripts\activate
Then re-run pip install roboto.
Optional features:
pip install roboto installs the core SDK. Some functionality depends on heavier third-party libraries that ship as optional extras, so you install them only when you need them:
| Extra | Install | Enables |
|---|---|---|
analytics |
pip install 'roboto[analytics]' |
Searching for similar signals (roboto.analytics.find_similar_signals) and reading topic data into pandas DataFrames (Topic.get_data_as_df, MessagePath.get_data_as_df). Adds fsspec, numpy, orjson, pandas, pyarrow, and stumpy. |
ingestion |
pip install 'roboto[ingestion]' |
Parsing and writing topic data as Parquet, e.g. when building ingestion actions. Adds pandas and pyarrow. |
video |
pip install 'roboto[video]' |
Extracting frames from video files (roboto.experimental.video). Adds av, numpy, and pillow. |
Without the matching extra, these code paths raise an ImportError naming the extra to install. For example, calling find_similar_signals without the analytics extra raises:
ImportError: Missing optional dependency 'stumpy'. Re-install roboto using pip or conda with 'roboto[analytics]' to install a compatible version.
The examples extra provides the tooling needed to run the SDK's example notebooks, namely ipython, jupyter, matplotlib, and pillow. Use pip install 'roboto[examples]' before trying out the included examples.
Getting Started
The example below accesses topic data from an ingested ROS bag file:
from roboto import Dataset
ds = Dataset.from_id("ds_9ggdi910gntp")
bag = ds.get_file_by_path("scene57.bag")
steering_topic = bag.get_topic("/vehicle_monitor/steering")
steering_data = steering_topic.get_data(
start_time="1714513576", # "<sec>.<nsec>" since epoch
end_time="1714513590",
)
You can also create events:
from roboto import Event
Event.create(
start_time="1714513580", # "<sec>.<nsec>" since epoch
end_time="1714513590",
name="Fast Turn",
topic_ids=[steering_topic.topic_id]
)
Or search for logs matching metadata and statistics with RoboQL:
from roboto import query, RobotoSearch
roboto_search = RobotoSearch(query.client.QueryClient())
query = '''
dataset.tags CONTAINS 'boston' AND
topics[0].msgpaths[/vehicle_monitor/vehicle_speed.data].max > 20
'''
results = roboto_search.find_files(query)
Or put an AI agent to work on your data and stream its findings as it goes:
from roboto.ai import AgentThread
from roboto.ai.agent_thread import AgentTextDeltaEvent
thread = AgentThread.start(
"Look at dataset ds_9ggdi910gntp and check /vehicle_monitor/steering for anomalies."
)
for event in thread.events():
if isinstance(event, AgentTextDeltaEvent):
print(event.text, end="", flush=True)
The same agents are available in the web app's AI Chat and on the command line via roboto chat start.
See the notebooks directory for complete examples!
CLI
Use the CLI for quick tasks: creating datasets, uploading or downloading files, and running actions. Use the Python SDK for full platform coverage, data analysis, and integration with your other tools.
To use Roboto from the command line without the Python SDK, install the standalone CLI.
Pre-built binaries for every version are on the releases page of this package. We build for Linux (aarch64, x86_64), macOS (aarch64, x86_64), and Windows (x86_64). See per-platform installation instructions below.
The CLI provides the roboto command line utility. List available commands with roboto -h, or see the complete CLI reference documentation.
Linux
Run:
curl -fsSL https://raw.githubusercontent.com/roboto-ai/roboto-python-sdk/main/install.sh | bash
It installs roboto into ~/.local/bin, adds that directory to your shell's PATH, and runs roboto setup. Or install it yourself:
- Go to the latest release page for this package
- (apt) Download the relevant
roboto.debfile for your platform- e.g.
roboto-linux-x86_64_0.9.2.deb(not aroboto-agentrelease) - Double-click the downloaded
.debfile to install it withapt
- e.g.
- (non-apt) Download the relevant
robotofile for your platform- e.g.
roboto-linux-x86_64(not aroboto-agentrelease) - Move the downloaded file to
/usr/local/binor another directory on yourPATH
- e.g.
Coming soon: direct apt-get install support
macOS
Run:
curl -fsSL https://raw.githubusercontent.com/roboto-ai/roboto-python-sdk/main/install.sh | bash
It installs roboto into ~/.local/bin, adds that directory to your shell's PATH, and runs roboto setup. Or install with the Homebrew package manager:
brew install roboto-ai/tap/roboto
Or download the relevant Mac binary, e.g. roboto-macos-aarch64, from the latest release page.
Windows
In PowerShell or Command Prompt, run:
powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/roboto-ai/roboto-python-sdk/main/install.ps1 | iex"
It installs roboto.exe into ~\.local\bin, adds that folder to your user PATH, and runs roboto setup. Or download roboto-windows-x86_64.exe from the latest release page and move it to a folder on your PATH.
Upgrade CLI
The CLI automatically checks for updates and notifies you when a new version is available.
Run roboto upgrade to upgrade it the way it was installed: a standalone binary is replaced in place, and a Homebrew install is upgraded with Homebrew. For a .deb, it prints the command that upgrades it.
Example
The example below creates a new dataset and uploads a file to it. In a Python environment with the SDK installed, the same commands are available via python -m roboto.cli.
> roboto datasets create --tag boston
{
"administrator": "Roboto",
"created": "2024-09-25T22:22:48.271387Z",
"created_by": "benji@roboto.ai",
"dataset_id": "ds_9ggdi910gntp",
...
"tags": [
"boston"
]
}
> roboto datasets upload-files -d ds_9ggdi910gntp -p scene57.bag
100.0%|█████████████████████████ | 58.9M/58.9M | 2.62MB/s | 00:23 | Src: 1 file
Connect Your AI Tools
The hosted Roboto MCP server brings Roboto to the AI you already work in. Connect it once, and Claude Code, Claude Desktop, Codex, Cursor, VS Code, or any other client that speaks the Model Context Protocol can search your Roboto data, explore datasets and files, and analyze topic data mid-conversation:
claude mcp add --transport http roboto https://mcp.roboto.ai/mcp
- You authenticate as yourself — sign in with your browser or use a personal access token; every tool call runs with your own permissions.
- Read-only by design — a curated set of search, retrieval, and analysis tools; nothing exposed over MCP can modify your data.
- All of your organizations, one connection — if you belong to several orgs, ask the AI to call
whoamiandset_active_orgto switch between them.
See Use the Roboto MCP Server for setup instructions per client, and the Roboto MCP Server docs for everything the AI can do once connected.
Data Formats
Roboto ingests the following formats, each with a corresponding action in the Action Hub.
| Format | Extensions | Status | Action |
|---|---|---|---|
| ROS 2 | .mcap, .db3 |
✅ | ros_ingestion |
| ROS 1 | .bag |
✅ | ros_ingestion |
| PX4 | .ulg |
✅ | ulog_ingestion |
| Parquet | .parquet |
✅ | parquet_ingestion |
| CSV | .csv |
✅ | csv_ingestion |
| ArduPilot | .bin, .log, .tlog |
✅ | ardupilot_ingestion |
| Video | .mp4, .avi, .mkv |
✅ | video_ingestion |
| Journal | .log |
✅ | journal_log_ingestion |
Roboto can also support custom formats. Reach out to discuss your use case.
Learn More
For more information, check out:
- General Docs
- AI Agents
- Use the Roboto MCP Server
- User Guides
- Example Notebooks
- SDK Reference
- CLI Reference
- About Roboto
Contact
Email us at info@roboto.ai or join our community Discord server.
Metadata
Release files for roboto 0.62.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| roboto-0.62.0.tar.gz | 742.4 kB | With provenance | Details for roboto-0.62.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| roboto-0.62.0-py3-none-any.whl | Python 3 | none | any | Details for roboto-0.62.0-py3-none-any.whl |
Total release size: 1.7 MB
Release files / roboto-0.62.0.tar.gz
| Download URL | roboto-0.62.0.tar.gz |
|---|---|
| Size | 742.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
48f5582c6d3bf796295258fd8b3d1a0abae6c901adf804d91c95bb216e9269cb
|
|
BLAKE2b-256 checksum How to use checksums |
62f0772fa6c52ea23fc73fb9ebdc7cc518fdcb840968275b6193cce47371b2fb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logRelease files / roboto-0.62.0-py3-none-any.whl
| Download URL | roboto-0.62.0-py3-none-any.whl |
|---|---|
| Size | 992.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
75e016e4d5252937f2ea6b3445e448fca293af976348be74dfa96a27da8a2b5f
|
|
BLAKE2b-256 checksum How to use checksums |
d315470a982206e9ad9b199aab6e5b7eccd1bb512a4f6d1d171a18e2d2bc3538
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logSecurity for roboto 0.62.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for roboto-0.62.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.