Grip is a prototyping toolbox for robot manipulation research powered by Bullet3. It contains a collection of tools for creating robot manipulation environments, loading arbitrary robot arms and grippers through URDF, as well as handling and acquiring data from simulated and real RGBD cameras. It also supports ROS2 allowing created environments or applications to be easily integrated with the ROS2 ecosystem.

1. Install

pip3 install git+https://github.com/dyson-ai/grip.git

2. Run simple example (pure-python)

python3 -m grip_examples.environments.ex01_pick_and_place

This will run a basic pick and place demo. You should see the robot picking and placing a an object on the table (see below).

3. Another example: loading a Franka Panda robot (pure-python)

python3 -m grip_examples.robot.ex02_robots

This will spawn a Franka Panda robot that can be controlled through joint sliders. See more examples at grip_examples.

Development with vscode and running more examples:

1. Clone this repository git clone https://github.com/dyson-ai/grip.git

2. Run vscode: code grip

3. F1 -> "dev containers: Reopen in Container"

4. Build repo with colcon: colcon build

A few basic ROS2 examples are showcased below.

Launch file:

ros2 launch grip ros_arm.launch.py

You should be able to see a simulation of a panda arm, and a pre-configured rviz displaying the robot model, state, and point cloud as below. The main node for this example is located at grip/grip_examples/robot/ex04_ros_robot.py. For more examples see grip/grip_examples and grip/launch.

Launch file:

ros2 launch grip moveit_demo.launch.py

You should be able to see a simulation of a panda arm, and a pre-configured rviz displaying the robot model, state, and point cloud, and moveit planning scene as below. The main node for this example is located at grip/grip_examples/robot/ex05_ros_robot_moveit.py. For more examples see grip/grip_examples and grip/launch.

The provided ROS2 interfaces should allow for ROS standard communication (e.g. if you want to connect the robot to moveit, or subscribe to its topics, tf, services, actions, sensors, etc)

Happy coding!