Metadata-Version: 2.4
Name: robocrew
Version: 0.3.0
Summary: Set up your embodied LLM agent same easiness as you set up normal agents in CrewAI or Autogen
Project-URL: Homepage, https://github.com/Grigorij-Dudnik/RoboCrew
Author-email: Grigorij Dudnik <dudnikgrv@gmail.com>, Konrad Suchodolski <konrad.suchodolski50@gmail.com>, Piotr Zarzycki <piotr.zarzycki@placeholder.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: djitellopy>=2.5.0
Requires-Dist: feetech-servo-sdk==1.0.0
Requires-Dist: google-ai-generativelanguage==0.9.0
Requires-Dist: grpcio==1.73.1
Requires-Dist: huggingface-hub>=0.35.3
Requires-Dist: langchain-google-genai==3.2.0
Requires-Dist: langchain-openai==1.1.0
Requires-Dist: langchain==1.1.0
Requires-Dist: lerobot==0.5.0
Requires-Dist: lerobot[async]==0.5.0
Requires-Dist: mcp>=1.27.0
Requires-Dist: openai==2.8.1
Requires-Dist: opencv-python==4.10.0.84
Requires-Dist: piper-tts>=1.4.1
Requires-Dist: pygame>=2.6.1
Requires-Dist: python-dotenv==1.2.1
Requires-Dist: rplidar>=0.9.2
Requires-Dist: speechrecognition>=3.15.1
Requires-Dist: streamlit>=1.54.0
Description-Content-Type: text/markdown

![Logo](https://raw.githubusercontent.com/Grigorij-Dudnik/RoboCrew-assets/master/Images/Logo/logo_text_v3.png)
<p align="center">
  <a href="https://github.com/Grigorij-Dudnik/RoboCrew/stargazers"><img src="https://img.shields.io/github/stars/Grigorij-Dudnik/RoboCrew?style=for-the-badge&color=gold&label=Stars" alt="Stars"></a>
  <a href="https://pypi.org/project/robocrew/"><img src="https://img.shields.io/pypi/dm/robocrew?style=for-the-badge&color=green" alt="Downloads"></a>
  <a href="https://discord.gg/MzFERWgvjU"><img src="https://img.shields.io/badge/Discord-Join%20Us-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
  <a href="https://grigorij-dudnik.github.io/RoboCrew-docs/"><img src="https://img.shields.io/badge/Docs-Read-orange?style=for-the-badge" alt="Docs"></a>
  <a href="https://pypi.org/project/robocrew/"><img src="https://img.shields.io/pypi/v/robocrew?style=for-the-badge&color=blue" alt="PyPI version"></a>
</p>

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


<p align="center">
  <img src="https://raw.githubusercontent.com/Grigorij-Dudnik/RoboCrew-assets/master/Demo_videos/robocrew_v3_9fps.gif" alt="RoboCrew demo" width="700">
</p>
<p align="center"><em>RoboCrew agent cleaning up a table.</em></p>




## 🚀 Quick Start

Run on your robot:

```bash
pip install robocrew
```
Start GUI app with:
```bash
robocrew-gui
```

## ✨ Features

![Schema](https://raw.githubusercontent.com/Grigorij-Dudnik/RoboCrew-assets/master/Images/main2.jpg)

- 🚗 **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 →](https://github.com/Grigorij-Dudnik/RoboCrew/issues)

## 🎯 How It Works

<div align="center">
<img src="https://raw.githubusercontent.com/Grigorij-Dudnik/RoboCrew-assets/master/Images/robot_agent.png" alt="How It Works Diagram" width="400">
</div>


**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:

```python
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](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](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](examples/4_xlerobot_multiagent_cooperation.py)

---

## 💬 Community & Support

- 💭 [Join our Discord](https://discord.gg/MzFERWgvjU) - Get help, share projects, discuss features
- 📖 [Read the Docs](https://grigorij-dudnik.github.io/RoboCrew/) - Comprehensive guides and API reference
- 🐛 [Report Issues](https://github.com/Grigorij-Dudnik/RoboCrew/issues) - Found a bug? Let us know!
- ⭐ [Star on GitHub](https://github.com/Grigorij-Dudnik/RoboCrew) - Show your support!

❤️ Special thanks to all contributors and early adopters!
