# hyperspawn/dropbear architecture

> Architecture diagram of the GitHub repository hyperspawn/dropbear, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hyperspawn/dropbear
- Repository: https://github.com/hyperspawn/dropbear

## Overview

Dropbear is a humanoid robotics project repository spanning ROS-based robot simulation and visualization, low-level/serial control, CAD exchange tooling, and an RT-2 model package. A user-facing route is to launch a robot model in Gazebo or RViz and exercise joint trajectories; separate branches support controller communication and CAD import/viewing. The README also describes build, locomotion, and connected-control capabilities, but several are external projects or files absent from this tree. Edges are limited to relationships visible in the README or source index; unsampled launch wiring is not inferred.

Main entry points: [`Software/Intelligence/RT-2 Vision-Language-Action Models/rtx/__init__.py`](https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx/__init__.py) (RTX Model Package), [`Software/Intelligence/RT-2 Vision-Language-Action Models/run.py`](https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/run.py) (Model Runner), [`Software/Intelligence/RT-2 Vision-Language-Action Models/rtx/rtx1.py`](https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx/rtx1.py) (RT-X 1 Model), [`Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/main.py`](https://github.com/hyperspawn/dropbear/blob/main/Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/main.py) (STEPper Add-on)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_robot_sim["Robot Simulation"]
  node_gazebo["Gazebo Launch"]
  node_simplified_gazebo["Simple Gazebo"]
  node_display_launch["Robot Display"]
  node_sim_launches["Simulation Launches"]
  node_trajectory_publishers["Joint Trajectories"]
  node_rviz_launches["RViz Launches"]
end

subgraph group_robot_control["Robot Control"]
  node_controller_ui["Control Dashboard<br/>[control_flask.py]"]
  node_motor_protocol["Motor Protocol"]
  node_serial_teleop["Serial Teleoperation<br/>[pyserialscript.py]"]
end

subgraph group_cad_tools["CAD Tools"]
  node_stepper_main["STEPper Add-on<br/>[main.py]"]
  node_stepper_importer["STEP Importer<br/>[importer.py]"]
  node_cad_exchange["CAD Exchange<br/>[DataExchange.py]"]
  node_cad_viewer["Shape Viewer<br/>[OCCViewer.py]"]
  node_occ_bindings["OpenCascade Bindings<br/>[Core]"]
end

subgraph group_vision_models["Vision Models"]
  node_rtx_package["RTX Model Package<br/>[__init__.py]"]
  node_rtx1["RT-X 1 Model<br/>[rtx1.py]"]
  node_rtx2["RT-X 2 Model<br/>[rtx2.py]"]
  node_efficient_net["EfficientNet<br/>[efficient_net.py]"]
  node_data_util["Data Utilities<br/>[data_util.py]"]
  node_model_runner["Model Runner<br/>[run.py]"]
  node_rtx_example["RT-X Example<br/>[rtx2_example.py]"]
end

node_builder(("Robot Builder"))

node_builder -.->|"launches"| node_gazebo
node_builder -.->|"views robot"| node_display_launch
node_stepper_main -->|"imports"| node_stepper_importer
node_model_runner -->|"references"| node_rtx1
node_model_runner -->|"references"| node_rtx_example
node_rtx_package -->|"imports"| node_rtx1
node_rtx_package -->|"imports"| node_rtx2
node_rtx_package -->|"imports"| node_efficient_net
node_rtx_package -->|"imports"| node_data_util

click node_gazebo "https://github.com/hyperspawn/dropbear/blob/main/CAD_Files/Assembly/Full_Body/URDF/dropbear_detailed_urdf/launch/dropbear_detailed_gazebo.launch.py"
click node_simplified_gazebo "https://github.com/hyperspawn/dropbear/blob/main/CAD_Files/Assembly/Full_Body/URDF/dropbear_simplified_urdf/launch/dropbear_gazebo.launch.py"
click node_display_launch "https://github.com/hyperspawn/dropbear/blob/main/CAD_Files/Assembly/Full_Body/URDF/dropbear_detailed_urdf/launch/dropbear_detailed_display.launch.py"
click node_sim_launches "https://github.com/hyperspawn/dropbear/tree/main/Sim/Gazebo/dropbear-sim/dropbear/launch"
click node_trajectory_publishers "https://github.com/hyperspawn/dropbear/tree/main/Sim/Gazebo/dropbear-sim/dropbear/dropbear"
click node_rviz_launches "https://github.com/hyperspawn/dropbear/tree/main/Sim/RViz"
click node_controller_ui "https://github.com/hyperspawn/dropbear/blob/main/Control%20System/Low%20Level%20Control/control_flask.py"
click node_motor_protocol "https://github.com/hyperspawn/dropbear/blob/main/Control%20System/Low%20Level%20Control/dropbear_motor_protocol.h"
click node_serial_teleop "https://github.com/hyperspawn/dropbear/blob/main/Control%20System/Teleoperation/Resources/Arduino/pyserialscript.py"
click node_stepper_main "https://github.com/hyperspawn/dropbear/blob/main/Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/main.py"
click node_stepper_importer "https://github.com/hyperspawn/dropbear/blob/main/Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/importer.py"
click node_cad_exchange "https://github.com/hyperspawn/dropbear/blob/main/Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/OCC/Extend/DataExchange.py"
click node_cad_viewer "https://github.com/hyperspawn/dropbear/blob/main/Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/OCC/Display/OCCViewer.py"
click node_occ_bindings "https://github.com/hyperspawn/dropbear/tree/main/Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/OCC/Core"
click node_rtx_package "https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx/__init__.py"
click node_rtx1 "https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx/rtx1.py"
click node_rtx2 "https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx/rtx2.py"
click node_efficient_net "https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx/efficient_net.py"
click node_data_util "https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx/data_util.py"
click node_model_runner "https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/run.py"
click node_rtx_example "https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx2_example.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gazebo,node_simplified_gazebo,node_display_launch,node_sim_launches,node_trajectory_publishers,node_rviz_launches toneBlue
class node_controller_ui,node_motor_protocol,node_serial_teleop toneAmber
class node_stepper_main,node_stepper_importer,node_cad_exchange,node_cad_viewer,node_occ_bindings toneMint
class node_rtx_package,node_rtx1,node_rtx2,node_efficient_net,node_data_util,node_model_runner,node_rtx_example toneRose
class node_builder toneIndigo
```

## Components

### Robot Simulation

- [Gazebo Launch](https://github.com/hyperspawn/dropbear/blob/main/CAD_Files/Assembly/Full_Body/URDF/dropbear_detailed_urdf/launch/dropbear_detailed_gazebo.launch.py): `CAD_Files/Assembly/Full_Body/URDF/dropbear_detailed_urdf/launch/dropbear_detailed_gazebo.launch.py`
- [Simple Gazebo](https://github.com/hyperspawn/dropbear/blob/main/CAD_Files/Assembly/Full_Body/URDF/dropbear_simplified_urdf/launch/dropbear_gazebo.launch.py): `CAD_Files/Assembly/Full_Body/URDF/dropbear_simplified_urdf/launch/dropbear_gazebo.launch.py`
- [Robot Display](https://github.com/hyperspawn/dropbear/blob/main/CAD_Files/Assembly/Full_Body/URDF/dropbear_detailed_urdf/launch/dropbear_detailed_display.launch.py): `CAD_Files/Assembly/Full_Body/URDF/dropbear_detailed_urdf/launch/dropbear_detailed_display.launch.py`
- [Simulation Launches](https://github.com/hyperspawn/dropbear/tree/main/Sim/Gazebo/dropbear-sim/dropbear/launch): `Sim/Gazebo/dropbear-sim/dropbear/launch`
- [Joint Trajectories](https://github.com/hyperspawn/dropbear/tree/main/Sim/Gazebo/dropbear-sim/dropbear/dropbear): `Sim/Gazebo/dropbear-sim/dropbear/dropbear`
- [RViz Launches](https://github.com/hyperspawn/dropbear/tree/main/Sim/RViz): `Sim/RViz`

### Robot Control

- [Control Dashboard](https://github.com/hyperspawn/dropbear/blob/main/Control%20System/Low%20Level%20Control/control_flask.py): `Control System/Low Level Control/control_flask.py`
- [Motor Protocol](https://github.com/hyperspawn/dropbear/blob/main/Control%20System/Low%20Level%20Control/dropbear_motor_protocol.h): `Control System/Low Level Control/dropbear_motor_protocol.h`
- [Serial Teleoperation](https://github.com/hyperspawn/dropbear/blob/main/Control%20System/Teleoperation/Resources/Arduino/pyserialscript.py): `Control System/Teleoperation/Resources/Arduino/pyserialscript.py`

### CAD Tools

- [STEPper Add-on](https://github.com/hyperspawn/dropbear/blob/main/Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/main.py): `Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/main.py`
- [STEP Importer](https://github.com/hyperspawn/dropbear/blob/main/Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/importer.py): `Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/importer.py`
- [CAD Exchange](https://github.com/hyperspawn/dropbear/blob/main/Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/OCC/Extend/DataExchange.py): `Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/OCC/Extend/DataExchange.py`
- [Shape Viewer](https://github.com/hyperspawn/dropbear/blob/main/Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/OCC/Display/OCCViewer.py): `Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/OCC/Display/OCCViewer.py`
- [OpenCascade Bindings](https://github.com/hyperspawn/dropbear/tree/main/Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/OCC/Core): `Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/OCC/Core`

### Vision Models

- [RTX Model Package](https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx/__init__.py): `Software/Intelligence/RT-2 Vision-Language-Action Models/rtx/__init__.py`
- [RT-X 1 Model](https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx/rtx1.py): `Software/Intelligence/RT-2 Vision-Language-Action Models/rtx/rtx1.py`
- [RT-X 2 Model](https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx/rtx2.py): `Software/Intelligence/RT-2 Vision-Language-Action Models/rtx/rtx2.py`
- [EfficientNet](https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx/efficient_net.py): `Software/Intelligence/RT-2 Vision-Language-Action Models/rtx/efficient_net.py`
- [Data Utilities](https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx/data_util.py): `Software/Intelligence/RT-2 Vision-Language-Action Models/rtx/data_util.py`
- [Model Runner](https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/run.py): `Software/Intelligence/RT-2 Vision-Language-Action Models/run.py`
- [RT-X Example](https://github.com/hyperspawn/dropbear/blob/main/Software/Intelligence/RT-2%20Vision-Language-Action%20Models/rtx2_example.py): `Software/Intelligence/RT-2 Vision-Language-Action Models/rtx2_example.py`

### Other components

- **Robot Builder**

## Connections

- Robot Builder → Gazebo Launch: launches
- Robot Builder → Robot Display: views robot
- STEPper Add-on → STEP Importer: imports (evidence: `Sim/Resources/Plugins/STEPper_1.1_for_Blender_version_2.93_or_later/STEPper/main.py`)
- Model Runner → RT-X 1 Model: references (evidence: `Software/Intelligence/RT-2 Vision-Language-Action Models/run.py`)
- Model Runner → RT-X Example: references (evidence: `Software/Intelligence/RT-2 Vision-Language-Action Models/run.py`)
- RTX Model Package → RT-X 1 Model: imports (evidence: `Software/Intelligence/RT-2 Vision-Language-Action Models/rtx/__init__.py`)
- RTX Model Package → RT-X 2 Model: imports (evidence: `Software/Intelligence/RT-2 Vision-Language-Action Models/rtx/__init__.py`)
- RTX Model Package → EfficientNet: imports (evidence: `Software/Intelligence/RT-2 Vision-Language-Action Models/rtx/__init__.py`)
- RTX Model Package → Data Utilities: imports (evidence: `Software/Intelligence/RT-2 Vision-Language-Action Models/rtx/__init__.py`)
