Skip to main content

Set up your embodied LLM agent same easiness as you set up normal agents in CrewAI or Autogen

Project description

Logo

Stars Downloads Discord Docs PyPI version

Create LLM agent for your robot. Connect movement tools, VLA policies and sensor scans just in a few lines of code.

RoboCrew demo

RoboCrew agent cleaning up a table.

🚀 Quick Start

Run on your robot:

pip install robocrew

Start GUI app with:

robocrew-gui

✨ Features

Schema

  • 🚗 Movement - Pre-built wheel controls for mobile robots
  • 🦾 Manipulation - VLA models as tools for arms control
  • 👁️ Vision - Camera feed with image augmentation for better spatial understanding
  • 🎤 Voice - Wake-word activated voice commands and TTS responses
  • 🗺️ LiDAR - Top-down mapping with LiDAR sensor
  • 🧠 Intelligence - Multi-agent control provides autonomy in decision making

🎨 Supported Robots

  • XLeRobot - Full support for all features
  • 🥝 LeKiwi - Use XLeRobot code (compatible platform)
  • 🚙 Earth Rover mini plus - Full support
  • 🔜 More robot platforms coming soon! Request your platform →

🎯 How It Works

How It Works Diagram

The RoboCrew Intelligence Loop:

  1. 👂 Input - Voice commands, text tasks, or autonomous operation
  2. 🧠 LLM Processing - LLM analyzes the task and environment...
  3. 🛠️ Tool Selection - ...and chooses appropriate tools (move, turn, grab an apple, etc.)
  4. 🤖 Robot Actions - Wheels and arms execute commands
  5. 📹 Visual Feedback - Cameras capture results with augmented overlay
  6. 🔄 Repeat - LLM evaluates results and adjusts strategy

📱 Scripts to Use:

To gain full control over RoboCrew features, you can create your own script. Simplest example:

from robocrew.core.camera import RobotCamera
from robocrew.core.LLMAgent import LLMAgent
from robocrew.robots.XLeRobot.tools import create_move_forward, create_turn_right, create_turn_left
from robocrew.robots.XLeRobot.servo_controls import ServoControler

# 📷 Set up main camera
main_camera = RobotCamera("/dev/camera_center")  # camera usb port Eg: /dev/video0

# 🎛️ Set up servo controller
right_arm_wheel_usb = "/dev/arm_right"  # provide your right arm usb port. Eg: /dev/ttyACM1
servo_controler = ServoControler(right_arm_wheel_usb=right_arm_wheel_usb)

# 🛠️ Set up tools
move_forward = create_move_forward(servo_controler)
turn_left = create_turn_left(servo_controler)
turn_right = create_turn_right(servo_controler)

# 🤖 Initialize agent
agent = LLMAgent(
    model="google_genai:gemini-3-flash-preview",
    tools=[move_forward, turn_left, turn_right],
    main_camera=main_camera,
    servo_controler=servo_controler,
)

# 🎯 Give it a task and go!
agent.task = "Approach a human."
agent.go()

🎤 Enable Listening and Speaking

Use voice to tell robot what to do.

📖 Docs: https://grigorij-dudnik.github.io/RoboCrew-docs/guides/examples/audio/

💻 Code example: examples/2_xlerobot_listening_and_speaking.py


🦾 Add VLA Policy as a Tool

Let's make our robot manipulate objects with its arms!

📖 Docs: https://grigorij-dudnik.github.io/RoboCrew-docs/guides/examples/vla-as-tools/

💻 Code example: examples/3_xlerobot_arm_manipulation.py


🧠 Increase intelligence with multiagent communication:

One agent plans mission, another controls robot.

📖 Docs: https://grigorij-dudnik.github.io/RoboCrew-docs/guides/examples/multiagent/

💻 Code example: examples/4_xlerobot_multiagent_cooperation.py


💬 Community & Support

❤️ Special thanks to all contributors and early adopters!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

robocrew-0.3.0.tar.gz (75.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

robocrew-0.3.0-py3-none-any.whl (80.2 kB view details)

Uploaded Python 3

File details

Details for the file robocrew-0.3.0.tar.gz.

File metadata

  • Download URL: robocrew-0.3.0.tar.gz
  • Upload date:
  • Size: 75.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for robocrew-0.3.0.tar.gz
Algorithm Hash digest
SHA256 1009b7b0ff539283fa666d7f3dc58d4fa73db2d1c3854d9792d803af3dd109ec
MD5 b181694759df94dde65f47871c032260
BLAKE2b-256 9c90bc352326d5bfb837c9993cf4136b99b154d00e8ade609bf6beac66c22bf3

See more details on using hashes here.

Provenance

The following attestation bundles were made for robocrew-0.3.0.tar.gz:

Publisher: publish.yml on Grigorij-Dudnik/RoboCrew

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file robocrew-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: robocrew-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 80.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for robocrew-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5ffec3e9079247170970e86eb4080a264c19844fca682bb94a0acb4f8a3a382f
MD5 3a67d75eeafd3b3eff320fe476fe5091
BLAKE2b-256 2a33b8747964a154b0a22a8423a9c005c7ef601bd044a6a49290c8345b04dde8

See more details on using hashes here.

Provenance

The following attestation bundles were made for robocrew-0.3.0-py3-none-any.whl:

Publisher: publish.yml on Grigorij-Dudnik/RoboCrew

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page