gitwtfhub

wtf is im.master-sdk?

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.

Mindmap

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

REASON 4

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

What's in the stack?

PythonBluetooth Low EnergyRaspberry Pi

How it stacks up

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 you spin it up?

Difficulty · moderate Time to first run · 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.

Wtf does this do

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.

Yoink these prompts

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

wtf is im.master-sdk?

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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.