google-deepmind/robotics-antigravity-plugin

visual-servoing

Aligns an eye-in-hand physical or simulated robot arm end-effector (SO-101, I2RT YAM, or MuJoCo robot grippers) and grasp orientation to sub-millimeter precision using robot IBVS (analytical hover-plane ray alignment or CPU OpenCV feature-matching IBVS).

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/google-deepmind/robotics-antigravity-plugin --skill visual-servoing

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Eye-in-Hand Visual Servoing (`Ibvs`)

Use bundled `Ibvs` (opencv-python numpy, CPU only, no GPU or torch) with calibrated camera intrinsics (fx_px, fy_px, cx_px, cy_px) and hand-eye extrinsics T_ee_cam:

  1. Choose the Visual Frontend by Target Texture:
  • Smooth / Low-Texture Objects: Segment the target foreground mask (passing an optional roi_mask to exclude any robot/gripper geoms visible in the FOV) and extract pose features via Ibvs.ray_plane_contour_pose or Ibvs.pca_contour_target(..., min_aspect=1.0, roi_mask=roi_mask, prev_theta_rad=...). Use det["anisotropy"] (eigval_max / eigval_min) to decide whether wrist yaw alignment is required vs. keeping neutral wrist roll on symmetric objects.
  • Textured Objects (CPU `match_keypoints`): Call m = match_keypoints(img_cur, img_goal, detector="sift", mask_cur=target_mask) ("orb" is faster; pass masks to exclude gripper fingers). It keeps Lowe-ratio matches with RANSAC homography inliers and returns m["u_px"], m["v_px"] -> m["u_goal_px"], m["v_goal_px"] for compute_step, or None when fewer than min_inliers survive (re-detect the target instead of servoing on bad matches).
  1. Analytical Hover-Plane Alignment (Known Support Plane `z_plane_m`, 2 Steps to `< 1 mm`):
  • Compute the optimal unoccluded hover clearance analytically from T_ee_cam via Ibvs.principal_ray_hover_distance(T_ee_cam, approach_axis_ee)["hover_distance_m"] (clamped to safe workspace clearance h_hover).
  • At hover, compute T_world_cam = T_world_ee(q_actual) @ T_ee_cam from measured joint states and call target = Ibvs.ray_plane_contour_pose(mask, fx_px, fy_px, cx_px, cy_px, T_world_cam, z_plane_m, roi_mask=roi_mask, prev_yaw_rad=...) (which back-projects the contour onto z_plane_m first with arc-length weighting so tilted-camera perspective never biases the 3D midpoint).
  • Command the robot's IK solver to (target["x_m"], target["y_m"]) (aligning jaw yaw to target["yaw_rad"] when target["anisotropy"] >= 2.0) until metric XY error ||(x_ee, y_ee) - (target["x_m"], target["y_m"])|| < pos_tol_m (or pixel error against servo.project_ee_point(h_actual * approach_axis_ee, T_ee_cam) converges).
  1. Full 6-DOF `IBVS` Velocity Step (Unknown Plane or Non-Planar Approach):
  • Pair each frame timestamp t_img with q_actual(t_img), instantiate servo = Ibvs(fx_px, fy_px, cx_px, cy_px) with depth z_depth_m (from aligned RGB-D or two-view triangulation), call step = servo.compute_step(u_px, v_px, z_depth_m, u_goal_px, v_goal_px, T_ee_cam), and integrate T_target = T_world_ee @ Ibvs.se3_exp(step["v_ee"], dt_s) into differential IK until step["converged"].
  1. Loop Protocol:
  • Fresh frame per step: Discard buffered frames before each capture, recompute T_world_cam from q_actual at capture time, and wait for each commanded step to finish before the next capture.
  • Iteration cap: Stop after ~10 hover-plane corrections or ~200 IBVS velocity steps without convergence; re-localize and re-plan instead of continuing.
  • Target lost: If detection returns None or the contour touches the image border, never extrapolate the last target. Retract 3–5 cm along -approach_axis_ee to widen the view and re-detect; if still lost, return to the look pose and re-localize with an object-localization skill.
  • Camera occlusion near the goal: If the gripper, tool, or held object will block the camera before the goal, stop servoing at the last pose where the target is fully visible and finish with a short, task-appropriate open-loop move. If the camera stays clear, servo all the way to the goal.
来自同一仓库

更多 Skills

全部 Skills
google-deepmind
社区

blender-creation

Creates physically calibrated, articulated, PBR-textured 3D MuJoCo assets (MJCF model.xml, .mjz, mjSpec) from scratch using headless Blender (bpy, bmesh, blendermeshutils, assetbuildutils), convex collision synthesis, 10-scenario auditing, and Studio preview. Use only when asked to create, model, or build a 3D MuJoCo object from a URL, image, or text description, or when blender-creation is named. Don't use for non-MuJoCo Blender/Cycles/CAD modeling.

1小时安装量
2
GitHub Stars
80
最近更新
11月17日
google-deepmind
社区

fr3-duo-control

Franka Duo robot only (Franka Research 3 / FR3 Duo dual-arm cell with Robotiq 2F-85 grippers, ZED Mini and RealSense D405 cameras). Brings up, homes, and controls it via pylibfranka on hardware or in MuJoCo sim. Use only when the user names Franka Duo, FR3 Duo, or fr3duo.

1小时安装量
2
GitHub Stars
80
最近更新
11月17日
google-deepmind
社区

i2rt-yam-bringup

Checks and installs the I2RT YAM SDK (i2rt), configures Linux socketcan or macOS gsusb CAN bringup for I2RT YAM robot arms, and provides a wave smoke test (wave.py). Use only before bringing up or programming a physical or simulated I2RT YAM robot arm, or when asked to run a wave gesture on an I2RT YAM robot. Don't use for non-YAM CAN bus debugging (e.g. automotive OBD-II or industrial PLC CAN networks) or non-robotics tasks.

1小时安装量
2
GitHub Stars
80
最近更新
11月17日
google-deepmind
社区

i2rt-yam-ik

Solves 6-DOF inverse kinematics for the I2RT YAM and YAM Pro robot arm using Mink + DAQP on combined YAM + gripper MJCF. Use only when computing joint targets or local Cartesian moves on an I2RT YAM or YAM Pro robot arm. Don't use for non-YAM inverse kinematics, general quadratic programming (QP) solvers, or non-robotics tasks.

1小时安装量
2
GitHub Stars
80
最近更新
11月17日