Set up your embodied LLM agent same easiness as you set up normal agents in CrewAI or Autogen
Project description
Create LLM agent for your robot. Connect movement tools, VLA policies and sensor scans just in a few lines of code.
RoboCrew agent cleaning up a table.
🚀 Quick Start
Run on your robot:
pip install robocrew
Start GUI app with:
robocrew-gui
✨ Features
- 🚗 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
The RoboCrew Intelligence Loop:
- 👂 Input - Voice commands, text tasks, or autonomous operation
- 🧠 LLM Processing - LLM analyzes the task and environment...
- 🛠️ Tool Selection - ...and chooses appropriate tools (move, turn, grab an apple, etc.)
- 🤖 Robot Actions - Wheels and arms execute commands
- 📹 Visual Feedback - Cameras capture results with augmented overlay
- 🔄 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
- 💭 Join our Discord - Get help, share projects, discuss features
- 📖 Read the Docs - Comprehensive guides and API reference
- 🐛 Report Issues - Found a bug? Let us know!
- ⭐ Star on GitHub - Show your support!
❤️ Special thanks to all contributors and early adopters!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file robocrew-0.3.1.tar.gz.
File metadata
- Download URL: robocrew-0.3.1.tar.gz
- Upload date:
- Size: 73.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a6c25a0f18b7d7d52a7efc199226a6175dfb1032213ff3845e75e3701a948c98
|
|
| MD5 |
d7ca6235ef2ff765a2b031fd903fa4d3
|
|
| BLAKE2b-256 |
28f216e1a8eeb2df9fff008045db5b2202bf83939eac3d48449f500f4a1326f9
|
Provenance
The following attestation bundles were made for robocrew-0.3.1.tar.gz:
Publisher:
publish.yml on Grigorij-Dudnik/RoboCrew
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
robocrew-0.3.1.tar.gz -
Subject digest:
a6c25a0f18b7d7d52a7efc199226a6175dfb1032213ff3845e75e3701a948c98 - Sigstore transparency entry: 1670439645
- Sigstore integration time:
-
Permalink:
Grigorij-Dudnik/RoboCrew@c749148f29bd14e61347f9fc3530c343fff0d994 -
Branch / Tag:
refs/tags/v0.3.1 - Owner: https://github.com/Grigorij-Dudnik
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c749148f29bd14e61347f9fc3530c343fff0d994 -
Trigger Event:
push
-
Statement type:
File details
Details for the file robocrew-0.3.1-py3-none-any.whl.
File metadata
- Download URL: robocrew-0.3.1-py3-none-any.whl
- Upload date:
- Size: 79.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4afbc8ab19ffb61cc0617486408460c80072991434636aff041a1ef87f2abb4f
|
|
| MD5 |
81af77c9283627c7ed866f7614de2ca0
|
|
| BLAKE2b-256 |
298d893d6d5cfe8a8e5aac943936ee497934533d882cfd933f609a12a66101c2
|
Provenance
The following attestation bundles were made for robocrew-0.3.1-py3-none-any.whl:
Publisher:
publish.yml on Grigorij-Dudnik/RoboCrew
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
robocrew-0.3.1-py3-none-any.whl -
Subject digest:
4afbc8ab19ffb61cc0617486408460c80072991434636aff041a1ef87f2abb4f - Sigstore transparency entry: 1670439775
- Sigstore integration time:
-
Permalink:
Grigorij-Dudnik/RoboCrew@c749148f29bd14e61347f9fc3530c343fff0d994 -
Branch / Tag:
refs/tags/v0.3.1 - Owner: https://github.com/Grigorij-Dudnik
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c749148f29bd14e61347f9fc3530c343fff0d994 -
Trigger Event:
push
-
Statement type: