REBOT ARM WEBUI

REBOT ARM WEBUI is an integrated control interface for the reBot Arm B601. The project combines the Web UI, URDF visualization, serial-device detection, arm connection flow, gripper control, diagnostics, and the local HTTP service in a single repository for straightforward deployment.

V0.2.1 Highlights

• Smooth Chinese and English language switching
• Arm presence detection before connection, with guided connection prompts
• One-click disconnect after a successful connection
• Immediate arm enabling after the connection is established
• Real arm absolute joint-position sync
• Gripper open and close controls
• Diagnostics page with per-motor tabs, zero recalibration, and duplicate motor filtering by feedback_id
• Application Center with curated reBot Arm project links
• One-line installation with automatic systemd service setup and startup

Requirements

• Linux device
• Python 3.10 to 3.12
• Node.js 18+
• npm
• curl
• Access to the robot arm serial interface, for example /dev/ttyACM0

Repository Layout

rebot-arm-webui/
|- app.js
|- index.html
|- kinematics_server.py
|- package.json
|- public/
|- scripts/
|  |- bootstrap.sh
|  |- install.sh
|  `- start.sh
`- vendor/
   `- reBotArm_control_py/

Installation

git clone https://github.com/Seeed-Projects/rebot_arm_webui.git
cd rebot_arm_webui
./scripts/install.sh

Start the service after installation:

./scripts/start.sh

Default URL:

http://127.0.0.1:8000/

One-Line Install And Run

Install the published v0.2.1 version from GitHub, create a systemd service, and start it immediately:

curl -fsSL https://raw.githubusercontent.com/Seeed-Projects/rebot_arm_webui/v0.2.1/scripts/bootstrap.sh | bash

By default the installer creates rebot-arm-webui.service and starts it on port 8000.

Useful service commands:

sudo systemctl status rebot-arm-webui
sudo systemctl restart rebot-arm-webui
sudo journalctl -u rebot-arm-webui -f

To install from a custom fork, mirror, or port:

REBOT_ARM_WEBUI_REPO_URL=git@github.com:Seeed-Projects/rebot_arm_webui.git \
REBOT_ARM_WEBUI_PORT=8001 \
bash -c "$(curl -fsSL https://raw.githubusercontent.com/Seeed-Projects/rebot_arm_webui/v0.2.1/scripts/bootstrap.sh)"

Development

Install dependencies:

./scripts/install.sh

Start the integrated service:

npm run start

Start on port 8001:

PORT=8001 npm run start:8001

Build the frontend:

npm run build

Device Permissions

If the serial device permissions are insufficient:

sudo chmod 666 /dev/ttyACM*

Notes

• Python dependencies are managed by the repository-level pyproject.toml.
• The robot arm driver and configuration are consolidated under vendor/reBotArm_control_py.
• kinematics_server.py loads the in-repo vendor directory by default and remains compatible with older external paths.