
Modular open-source brain for legged robots. Web UI for teleops, autonomous navigation, mapping & monitoring. 3D-printable hardware that runs on ROS2.
Repo botbotrobotics/BotBrain, read from GitHub 19 h ago. botbotrobotics has not joined Take My Repo.
botbotrobotics/BotBrain is a public repo on GitHub by botbotrobotics. Modular open-source brain for legged robots. Web UI for teleops, autonomous navigation, mapping & monitoring. 3D-printable hardware that runs on ROS2. It declares the MIT license on GitHub. It is written mainly in TypeScript, has 397 stars and last changed on 2026-06-16. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-20.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
One Brain, any Bot.
BotBrain is a modular collection of open source software and hardware components that lets you drive, see, map, navigate (manually or autonomously), monitor, and manage legged (quadrupeds, bipeds and humanoids) or wheeled ROS2 robots from a simple but powerful web UI. The hardware gives you 3D printable mounts and an outer case so you can put BotBrain on your robot without guesswork.
๐น Watch BotBrain intro video ๐น
๐น Watch BotBrain complete 1 hour of autonomous patrols in our office
Quick to 3D print, easy to build, and designed to snap onto any robot. Get your robot running with BotBrain in less than 30 minutes.
๐น Watch BotBrain hardware assembly guide
BotBrain consists of three main components:
A 3D printable enclosure with internal mounts designed to house an NVIDIA Jetson board and two Intel RealSense D435i cameras. The modular design allows you to attach BotBrain to various robot platforms without custom fabrication.
A Next.js 15 web dashboard built with React 19 and TypeScript. It provides real-time robot control, camera streaming, map visualization, mission planning, system monitoring, and fleet managementโall accessible from any browser on your network.
A collection of ROS2 Humble packages that handle:
bot_bringup) - System launch and coordinationbot_localization) - RTABMap-based SLAM for mapping and positioningbot_navigation) - Nav2 integration for autonomous movementbot_yolo) - YOLOv8/v11 object detectionJoin our discord server for discussion on BotBrain and Robotics
BotBrain/
โโโ frontend/ # Next.js 15 web dashboard (React 19, TypeScript)
โโโ botbrain_ws/ # ROS 2 Humble workspace
โ โโโ src/
โ โโโ bot_bringup/ # Main launch & system orchestration
โ โโโ bot_custom_interfaces/# Custom ROS 2 messages, services, actions
โ โโโ bot_description/ # URDF/XACRO models & robot_state_publisher
โ โโโ bot_jetson_stats/ # Jetson hardware monitoring
โ โโโ bot_localization/ # RTABMap SLAM
โ โโโ bot_navigation/ # Nav2 autonomous navigation
โ โโโ bot_rosa/ # ROSA AI natural language control
โ โโโ bot_state_machine/ # Lifecycle & state management
โ โโโ bot_yolo/ # YOLOv8/v11 object detection
โ โโโ g1_pkg/ # Unitree G1 support
โ โโโ go2_pkg/ # Unitree Go2 support
โ โโโ joystick-bot/ # Game controller interface
โ โโโ tita_pkg/ # DirectDrive Tita robot support
โโโ hardware/ # 3D printable enclosure (STL/STEP/3MF)
โโโ docs/ # Documentation
| Component | Requirement |
|---|---|
| Compute | NVIDIA Jetson (Nano, Orin Nano, or AGX series) |
| Cameras | 2x Intel RealSense D435i |
| Robot | ROS2 Humble robot or Unitree Go2 and Go2-W, Unitree G1, Direct Drive Tita, or custom robot |
| Network | Ethernet or WiFi connection |
| Component | Requirement |
|---|---|
| OS | JetPack 6.2 (Ubuntu 22.04) recommended |
| Container | Docker & Docker Compose |
| Node.js | v20+ (for local frontend development only) |
BotBrain has two main components: hardware (3D printed enclosure and internal components) and software (frontend web app and ROS2 workspace).
3D print the enclosure and assemble the electronics.
Key Parts: 3D printer, PLA filament, NVIDIA Jetson, 2x RealSense D435i, voltage converter.
Hardware Assembly Guide - Detailed instructions on how to build your BotBrain
Complete Assembly Video - Full step-by-step video walkthrough of the BotBrain assembly process
The web dashboard requires Supabase for authentication and data storage. You'll need to create your own free Supabase project.
Supabase Setup Guide - Complete instructions with database schema
Quick summary:
G1 WiFi Setup Guide - If you are using G1 robot, please refeer to this docs before.
Operating System:
Docker & Docker Compose:
Required for containerized deployment:
# Add Docker's official GPG key: sudo apt-get update sudo apt-get install ca-certificates curl sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc sudo chmod a+r /etc/apt/keyrings/docker.asc # Add the repository to Apt sources: echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update # Install Docker packages: sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
See official Docker installation guide for more details.
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp dockerSee post-installation steps for more details.
Step 1: Clone the Repository
git clone https://github.com/botbotrobotics/BotBrain.git
cd BotBrainStep 2: Run Installation Script
The automated installation script will configure your robot and set up the autostart service:
sudo ./install.sh
More details about the information asked in the installer can be found here
Step 3: Reboot the System
sudo reboot
Once rebooted, the system will automatically start the Docker containers for all ROS2 nodes and the web server.
Step 4: Access the Web Interface
| Access Method | URL |
|---|---|
| Same computer | http://localhost |
| Network access | http://<JETSON_IP> |
Find your Jetson's IP address:
hostname -I
Note: Ensure both devices are on the same network and port 80 is not blocked by a firewall.
Note: Also if you selected g1-internal, your web port will be 3000. So your web ip will be: http://<JETSON_IP>:3000
For local frontend development (without the full robot stack):
cd frontend # Copy environment template cp .env.example .env.local # Edit with your Supabase credentials nano .env.local
| Variable | Required | Description |
|---|---|---|
NEXT_PUBLIC_SUPABASE_URL |
Yes | Your Supabase project URL |
NEXT_PUBLIC_SUPABASE_ANON_KEY |
Yes | Your Supabase anon/public key |
NEXT_PUBLIC_ROS_IP |
No | Default robot IP (default: 192.168.1.95) |
NEXT_PUBLIC_ROS_PORT |
No | ROS bridge port (default: 9090) |
# Install dependencies npm install # Development server (full features) npm run dev # Development server (open source edition) npm run dev:oss # Production build npm run build npm start
Edit botbrain_ws/robot_config.yaml:
robot_configuration: robot_name: "my_robot" # Namespace for all topics robot_model: "go2" # go2, tita, g1, or custom network_interface: "eth0" # Network interface for ROS2 openai_api_key: "" # For AI features (optional)
Camera serial numbers and transforms are configured per robot in:
botbrain_ws/src/go2_pkg/config/camera_config.yamlbotbrain_ws/src/g1_pkg/config/camera_config.yamlbotbrain_ws/src/tita_pkg/config/camera_config.yamlFind your camera serial numbers:
rs-enumerate-devices | grep "Serial Number"
To add support for a new robot platform to BotBrain:
ros2 node list | grep rosbridgesudo ufw allow 9090rs-enumerate-devicescamera_config.yaml match your camerassudo usermod -a -G video $USERdocker run --gpus all nvidia/cuda:11.0-base nvidia-smidocker compose logs -f bringup.env.localnode --versionros2 topic echo /cmd_vel_outros2 lifecycle get /robot_write_nodeJoin our Discord community for real-time support and discussions with the BotBrain community.
We welcome contributions! Whether you're fixing bugs, adding features, improving documentation, or adding support for new robots, your help is appreciated. If you can make BotBrain better or faster, bring it.
Join our Discord server to discuss ideas, get help, or coordinate with other contributors.
Fork the Repository
# Fork via GitHub UI, then clone your fork git clone https://github.com/botbotrobotics/BotBrain.git cd BotBrain
Create a Feature Branch
git checkout -b feature/your-amazing-feature
Make Your Changes
Test Thoroughly
Commit Your Changes
git add . git commit -m "Add feature: brief description of changes"
Push to Your Fork
git push origin feature/your-amazing-feature
Submit a Pull Request
Professional / Enterprise version of BotBrain with IP67 protection, custom payloads like CamCam (Thermal + infrared Camera), ZoomZoom (long range 30x RGB camera), advanced AI models, IoT integration (LoRA), 3-5g data connectivity, service and maintianance, advanced integrations with custom payloads, and much more. Learn more here or book your test drive now.
Robots can hurt people and themselves when operated incorrectly or during development. Please observe these safety practices:
Disclaimer: BotBot is not responsible for any failures, accidents, or damages resulting from the use of this software or hardware. The user assumes full responsibility for the safe operation, testing, and deployment of robots using BotBrain.
See docs/DEPENDENCIES.md for a complete list of frontend and ROS packages used.
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ๐ in Brazil
botbotrobotics/BotBrain is a public repo on GitHub by botbotrobotics. Modular open-source brain for legged robots. Web UI for teleops, autonomous navigation, mapping & monitoring. 3D-printable hardware that runs on ROS2.
It declares the MIT license on GitHub.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-06-16. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.
Python sample codes and textbook for robotics algorithms.
Open Source Computer Vision Library
ProtoMotions is a GPU-accelerated simulation and learning framework for training physically simulated digital humans and humanoid robots.
Flutter makes it easy and fast to build beautiful apps for mobile and beyond
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source โ self-host for your organization with complete privacy.

This page is also available as structured data, with the same sources and dates.
/api/v1/resources/gh/botbotrobotics/BotBrainTake My Repo has not tested this on your machine. Requirements come from the project's own documentation.