Gadget Panda

One Python host. Three toys. Infinite maker projects.

IDEA → CODE → PROTOTYPE → COMMUNITY

Open-source runtime for makers who want raw sensors and real control — not a locked wellness app.

pip install 'gadgetpanda[ui]'

Docs · Protocol · PyPI · Issues

Devices

gadgetpanda ring ui --demo
gadgetpanda dog ui --demo
gadgetpanda drone ui --demo

Why Gadget Panda

• Host-side Python — scan, connect, stream, and command from a laptop or Pi
• Realtime UIs — included with [ui] (black / red / gold)
• Fine-grained APIs — callbacks, CLI shells, optional MQTT
• MIT — fork it, ship it, teach with it

Quick start — Ring

import asyncio
from gadgetpanda import Ring

async def main():
    ring = await Ring.find()
    ring.on("heart_rate", lambda s: print("HR", s.bpm))
    ring.on("imu", lambda samples: print(samples[0] if samples else ""))
    ring.on("ppg", lambda samples: print("ppg", len(samples)))
    async with ring:
        await ring.set_raw_enabled(True)
        await asyncio.Event().wait()

asyncio.run(main())

gadgetpanda ring scan
gadgetpanda ring live
gadgetpanda ring ppg
gadgetpanda ring ui --mode ppg

Modes: all · BLE HR · PPG+HR · vitals · motion · activity
Docs: concept · protocol

SoftDog

gadgetpanda dog scan
gadgetpanda dog connect <addr> --shell
gadgetpanda dog action <addr> sit_down
gadgetpanda dog ui <addr>          # React remote @ :8766
gadgetpanda dog ui --demo

from gadgetpanda.dog import Dog, Action, Move

async with Dog(address) as dog:
    await dog.action(Action.SIT_DOWN)
    await dog.hold_move(Move.FORWARD, seconds=1.0)
    await dog.run_program([Action.JUMP, Move.TURN_LEFT, Action.VOICE])

Docs: dog concept · dog protocol

FLOW-UFO

gadgetpanda drone wifi join "FLOW-UFO-xxxx"
gadgetpanda drone scan
gadgetpanda drone ui --wifi "FLOW-UFO-xxxx" --model flow
gadgetpanda drone ui --demo

from gadgetpanda.drone import Drone

async with Drone("192.168.1.1", model="flow") as drone:
    await drone.command("takeoff")
    await drone.hold_stick("forward", seconds=1.5)
    await drone.command("land")

FPV remote: http://127.0.0.1:8767 (needs craft Wi‑Fi + ffmpeg via [ui])
Docs: drone concept · drone protocol

Install

pip install gadgetpanda           # core (BLE + drone protocol)
pip install 'gadgetpanda[ui]'     # dashboards + FPV
pip install 'gadgetpanda[mqtt]'   # MQTT bridge

From source:

git clone https://github.com/gadgetpanda/gadgetpanda.git
cd gadgetpanda
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[ui,dev]"

Needs: Python 3.11+ · real BLE / Wi‑Fi hardware
Docker (Linux): host network + BlueZ — docs/docker.md

CLI map

Soft license (optional)

Honor-system feature keys. Soft by default — no key means open.
See docs/license.md.

gadgetpanda license features
gadgetpanda license activate gp_live_…
gadgetpanda license status