【免费下载链接】mosaicoMosaico - The data platform for Physical AI项目地址https://gitcode.com/gh_mirrors/mosai/mosaico点击查看免费下载Mosaico 是面向机器人与 Physical AI 的开源数据平台。本教程带你用最快的方式完成 mosaicod 守护进程安装并通过 Python SDKmosaicolabs在 5 分钟内建立第一条连接列出你的第一组 Sequence。整个过程只需要两个组件服务端mosaicod 客户端mosaicolabs。先看懂 Mosaico 的双组件架构Mosaico 采用经典的客户端-服务器模型你只需记住下面两个角色组件语言职责源码位置mosaicodRust服务端守护进程负责存储、目录管理、数据摄入与检索mosaicod/crates/mosaicolabsPython客户端 SDK通过 gRPC Apache Arrow 与守护进程通信mosaico-sdk-py/没有运行中的mosaicod任何客户端调用都不会成功。所以本文顺序是先装 daemon再装 SDK最后连接。两个组件之间基于 Apache Arrow 列式格式传输数据实现零拷贝交换这也是 Mosaico 相比.bag/.mcap单体文件能高效随机检索的关键。5分钟环境准备Mosaico 系统要求开始之前确认你的环境满足以下条件操作系统Linux 或 macOSWindows 用户请先安装 WSL2 Ubuntu然后在其中操作Python3.10 或更高版本Docker可选仅在使用容器方式部署mosaicod时需要端口mosaicod默认监听6726端口请确保未被占用一键安装mosaicod两种快速方法方法一官方一行安装脚本推荐新手最快的方式是执行官方安装脚本它会自动装好mosaicod与配套命令curl -fsSL https://get.mosaico.dev | sh脚本结束后你会得到可用的mosaicod和mosaicoctl命令手册页面可通过man mosaico查看可选安装的 Python SDK 建议先以 dry-run 模式预览脚本将执行的每一步不做任何磁盘修改curl -fsSL https://get.mosaico.dev | sh -s -- --dry-run方法二Docker Compose 容器化部署如果你更喜欢自己管理容器可以用一个精简的 compose 文件快速拉起mosaicod PostgreSQLservices: db: image: postgres:18 environment: POSTGRES_HOST_AUTH_METHOD: trust mosaicod: image: ghcr.io/mosaico-labs/mosaicod:latest environment: MOSAICOD_DB_URL: postgresql://db:5432/postgres MOSAICOD_DB_USER: postgres MOSAICOD_STORE_ENDPOINT: file:///tmp MOSAICOD_STORE_BUCKET: mosaico command: server --host 0.0.0.0 depends_on: - db ports: - 6726:6726该配置会在本机/tmp/mosaico生成数据目录可通过MOSAICOD_STORE_ENDPOINT修改。如需包含 cleanup、store-optimizer 等后台维护任务的完整生产级配置可参考 docs/main/docs/daemon/install.md 中的标准 compose 文件开发环境配置见 docker/devel/compose.yml。验证 daemon 是否正常运行安装完成后用ps子命令查看已注册的mosaicod实例该命令会同时汇总清理例程状态mosaicod ps命令的完整参数说明可参考 docs/main/docs/daemon/cli.md。如果输出中出现 server 实例记录说明守护进程已就绪。快速安装Python SDK一条pip命令确认mosaicod在运行后安装客户端 SDK 只需一条命令pip install mosaicolabsmosaicolabs提供了完整数据生命周期的高层 API摄入传感器数据、查询目录、把数据直接流式拉进 ML 流水线无需任何自定义序列化代码。SDK 客户端入口是MosaicoClient.connect()工厂方法唯一推荐的实例化方式直接__init__会抛出RuntimeError实现位于 mosaico_client.py。完成第一次Mosaico连接MosaicoClient 完整示例现在用下面的脚本连接本地守护进程并列出所有 Sequencefrom mosaicolabs import MosaicoClient # 连接本地 Mosaico 服务器 with MosaicoClient.connect(hostlocalhost, port6726) as client: # 列出所有可用的 Sequence sequences client.list_sequences() print(fConnected! Found sequences: {sequences})几个关键细节MosaicoClient.connect()建立到指定 host/port 的 gRPC 通道可选参数还包括timeout、enable_tls、api_key等作为上下文管理器使用可确保连接在任何异常情况下都被干净关闭list_sequences()返回字符串列表实现在 mosaico_client.py。全新实例输出Connected! Found sequences: []是完全正常的——空列表本身就证明连接成功了 ✅连接成功后把第一条数据写进去连接打通后建议立即写入一条数据验证全链路。写入流程遵循三层结构Sequence → Topic → Message三步走client.sequence_create()创建一个录制会话返回SequenceWriterswriter.topic_create()绑定一个 Ontology 类型如内置的IMU返回TopicWriter循环调用push()推送带纳秒时间戳的MessageMosaico 的 Ontology 类型系统会自动为内置类型IMU、GPS、Pressure等完成校验与 Arrow 列式存储自定义传感器类型也可以零改动地融入完整可运行的 CSV 摄入示例含三层错误处理策略见 docs/main/docs/learn/writing_single_topic.mdx。常见陷阱mosaicod连接失败排查清单第一次连接失败大多出在下面几处按表自查即可现象可能原因解决办法连接超时 /ConnectionErrormosaicod没有运行先执行mosaicod ps确认实例存在容器内能连、宿主机连不上端口映射未绑定确认 compose 中ports为6726:6726且--host 0.0.0.0连接立即失败端口被其他进程占用换一个空闲端口SDK 侧同步修改port参数import mosaicolabs报错Python 版本过低升级到 Python 3.10下一步从连接到数据流水线打通第一次连接后建议按这条路径继续写数据单 Topic 摄入、多 Topic 交错写入见 learn/ 指南目录查数据按时间窗口、Topic 过滤查询 Sequence同样在 learn 目录下有专题教程对接 ROS / MCAPSDK 内置 Bridge 可直接转换 ROS bag 与 MCAP 文件把非同步的传感器流自动整理为张量就绪的训练批次 恭喜你已用 5 分钟跑通了 Mosaico 的核心链路安装 mosaicod → 安装 Python SDK → 完成第一次连接。接下来就是把你的真实传感器数据灌进去吧。赞分享【免费下载链接】mosaicoMosaico - The data platform for Physical AI项目地址https://gitcode.com/gh_mirrors/mosai/mosaico点击查看免费下载相关推荐Headroom 快速上手5 分钟完成安装、启动代理并接入 Python SDKHeadroom 快速上手5 分钟完成安装、启动代理并接入 Python SDK Headroom 是一个位于 LLM 应用与模型 API 之间的上下文优化层人工智能大模型LLM网关AI Agent5分钟快速上手mcpc安装、登录并连接你的第一个MCP服务器新手完整教程5分钟快速上手mcpc安装、登录并连接你的第一个MCP服务器新手完整教程 mcpc 是目前兼容性最强的 MCPModel Context ProtocoOptiScaler Client快速上手教程5分钟完成首次扫描并安装OptiScalerOptiScaler Client快速上手教程5分钟完成首次扫描并安装OptiScaler OptiScaler Client 是一款现代游戏超分辨率管理工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考