KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

rby1-sdk

★ 64 Open GitHub ↗

Official Python and C++ SDK for seamless control and development of the Rainbow Robotics RB-Y1 robot.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# rby1-sdk

**rby1-sdk** is an SDK designed for seamless control and development with the RB-Y1 robot. It provides Python and C++
APIs,
making it easy to integrate into various applications, from basic scripting to advanced real-time control.

# Installation

## Python

Install SDK via ``pip``:

```bash
pip install rby1-sdk
```

Alternatively, install from source:

```bash
pip install .
# or
poetry install
```

## C++

### Build From Source

#### Step 1: Install Conan

[Conan](https://conan.io/) is required for dependency management:

```bash
pip install conan
```

#### Step 2: Clone the Repository

```bash
git clone --recurse-submodules git@github.com:RainbowRobotics/rby1-sdk.git
```

#### Step 3: Install or Build Dependencies

```bash
conan install . -s build_type=Release -b missing -of build
```

> [!NOTE]
> On `aarch64` platforms (e.g., ARM64 Ubuntu runners), please make sure to set the appropriate compiler explicitly:
>
> ```bash
> export CC=/usr/bin/aarch64-linux-gnu-gcc
> ```

#### Step 4: Configure, Build, and Install

##### (Option 1) CMake >= 3.23

```bash
cmake --preset conan-release -D BUILD_EXAMPLES=ON
cmake --build --preset conan-release

# Install
cmake --build --preset conan-release --target install
```

##### (Option 2) CMake < 3.23

```bash
cd build
cmake .. -G "Unix Makefiles" -DCMAKE_TOOLCHAIN_FILE=./conan_toolchain.cmake -DCMAKE_POLICY_DEFAULT_CMP0091=NEW -DCMAKE_BUILD_TYPE=Release -DBUILD_EXAMPLES=ON
cmake --build . # or make

# Install
make install
```

# Get Started

## Python Example

```python
import rby1_sdk as rby

robot = rby.create_robot("localhost:50051", "a")
robot.connect()
print(robot.get_robot_info())
```

## C++ Example

```c++
#include "rby1-sdk/robot.h"
#include "rby1-sdk/model.h"

int main() {
  auto robot = rb::Robot<rb::y1_model::A>::Create("localhost:50051");
  robot->Connect();
  std::cout << robot->GetRobotInfo().robot_version << std::endl;
}
```

## ARM Intellisense Issue

For issues with ARM Intellisense, refer to the
following [GitHub Issue](https://github.com/microsoft/vscode-cpptools/issues/7413).

To fix the Intellisense problem, add the following code at the top of your source file:

```c++
// Add this at the top of your source file
#if __INTELLISENSE__
#undef __ARM_NEON
#undef __ARM_NEON__
#endif
```

## Resources and Support

- Documentation: [https://rainbowrobotics.github.io/rby1-dev/](https://rainbowrobotics.github.io/rby1-dev/)
- Official Website: [Rainbow Robotics](https://www.rainbowrobotics.com/rby1eng)
- Official Support Email: rby.support@rainbow-robotics.com
- GitHub Discussions: [Join the Discussion](https://github.com/RainbowRobotics/rby1-sdk/discussions)

rby1-sdk

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README