git404hub

what is im.master-sdk fr?

2alf/im.master-sdk — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

A Python SDK that lets you drive a toy robot called iM.Master from code, with an optional local AI vision addon.

vibe map

mindmap
  root((iM.Master SDK))
    What it does
      Controls a toy robot
      Reverse engineered Bluetooth
      Optional AI steering
    Tech stack
      Python
      Bluetooth Low Energy
      Raspberry Pi
    Use cases
      Scripted robot movement
      Camera plus local LLM control
      Hardware free testing
    Audience
      Developers
      Hobbyists
    Safety
      Automatic stop watchdog
      Dry run simulation
      No cloud dependency

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Control a iM.Master toy robot from Python instead of its official phone app.

VIBE 2

Build a simple see-think-act loop that lets a local AI model steer the robot using camera input.

VIBE 3

Test robot control logic on a laptop without hardware using the built in dry run mode.

VIBE 4

Study a real example of reverse engineered Bluetooth Low Energy protocol decoding.

what's the stack?

PythonBluetooth Low EnergyRaspberry Pi

how it stacks up fr

2alf/im.master-sdk0marildo/imago0xdfi/glm-5.2-1m-4x-dgx-spark
Stars333
LanguagePythonPythonPython
Setup difficultymoderateeasyhard
Complexity3/52/55/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Controlling the physical robot needs a Raspberry Pi running as root, the AI addon also needs a local LLM runtime like Ollama.

MIT license, free to use, modify, and share as long as the original copyright notice is kept.

in plain english

iM.Master SDK is a Python library for controlling a toy robot called iM.Master that normally only works through its own phone app. The robot has no official remote control or programming interface, so the project figured out how the app talks to the robot over Bluetooth Low Energy and rebuilt that communication in plain Python, letting you drive the robot directly from code with commands like moving forward for a set number of seconds or spinning in place. The core of the SDK has no external dependencies and only needs the Python standard library. On top of that, there is an optional add-on that lets a small AI model steer the robot. You can point a camera, such as an old phone running a camera app, at the robot's surroundings, run object detection on a Raspberry Pi, and have a local language model decide which direction to move based on what the camera sees. The project describes running this whole loop, camera to detector to AI to robot, entirely on local hardware with no cloud service involved. Because moving the actual robot requires low level Bluetooth access, that part only works on Linux, in practice a Raspberry Pi running the script as an administrator. The pure command building and decoding logic, however, works on any operating system, including Windows and macOS, and there is even a simulated robot mode that lets you test the whole AI control loop without any physical hardware connected. The SDK includes a safety feature: if the control program crashes or stops sending commands, the robot automatically stops itself instead of continuing to drive blindly. The project is released under the MIT license, is written in Python 3.10 or newer, and can be installed either through pip or by cloning the repository directly.

prompts (copy fr)

prompt 1
Walk me through installing iM.Master SDK and sending my first drive command to the robot.
prompt 2
Explain how the reverse engineered Bluetooth protocol frame works in this SDK.
prompt 3
Help me set up the local LLM control loop that lets a model steer the robot using camera input.
prompt 4
Show me how to test the AI control loop without a physical robot using dry run mode.

Frequently asked questions

what is im.master-sdk fr?

A Python SDK that lets you drive a toy robot called iM.Master from code, with an optional local AI vision addon.

What language is im.master-sdk written in?

Mainly Python. The stack also includes Python, Bluetooth Low Energy, Raspberry Pi.

What license does im.master-sdk use?

MIT license, free to use, modify, and share as long as the original copyright notice is kept.

How hard is im.master-sdk to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is im.master-sdk for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.