Quick Start

pip install --index-url https://mirrors.aliyun.com/pypi/simple/ \
  --extra-index-url https://intuition-robot-monitor.oss-cn-shanghai.aliyuncs.com/dl/simple/ \
  --trusted-host mirrors.aliyun.com \
  intuition-sdk

import intuition

robot = intuition.Robot(
    api_key="ak_XXXXXXXXXXXXXXXX",           # ← your key from the dashboard
    name="robot-01",                       # ← a name for THIS robot
    server="http://<your-relay>:8080",      # ← your cloud URL (on the dashboard)
)
robot.attach_video("env", device="test:")    # ← synthetic test pattern, no camera needed
robot.run()                                  # stream + live dashboard; Ctrl-C to stop

# read the verdict from anywhere in your code:
s = robot.status()
if s and s.latest.verdict == "fail":
    stop_the_line()

intuition detect

intuition doctor --server http://<your-relay>:8080

import intuition

robot = intuition.Robot(
    api_key="ak_XXXXXXXXXXXXXXXX",          # ← your API key from the dashboard
    name="robot-01",                      # ← a name for THIS robot (reuse it to keep history)
    server="http://<your-relay>:8080",     # ← your cloud URL (shown on the dashboard)
)

robot.attach_video("env",     device="0")   # workspace cam (Linux also /dev/video0)
robot.attach_video("wrist_l", device="1")   # left wrist cam
robot.attach_video("wrist_r", device="2")   # right wrist cam
# No camera yet? use device="test:" for a synthetic test pattern.
# options (defaults): width=1280, height=720 (auto-probed), fps=30, bitrate_kbps=4000

robot.run()          # blocks; Ctrl-C to stop and save this run's verdicts

s = robot.status()                          # snapshot; None until the first verdict
if s and s.latest.verdict == "fail":        # same as s["latest"]["verdict"]
    print("last cycle failed:", s.latest.cycle_id)
    print("success rate:", s.success_rate)  # 0.0 – 1.0
    print("totals:", s.totals.fail, "fail /", s.totals.total, "total")

import time
while True:
    if robot.latest.verdict == "fail":      # None until the first verdict
        stop_the_line()
    time.sleep(2)

with robot.cycle(part_serial="SN-48213"):
    run_one_task()          # the verdict for this cycle binds to SN-48213

# Or open / close explicitly:
cid = robot.begin_cycle(part_serial="SN-48214")   # returns the cycle_id
run_one_task()
robot.end_cycle()

import intuition, time

# A read-only loop: the SAME account key (ak_) — one key streams and reads.
robot = intuition.Robot(api_key="ak_XXXXXXXXXXXXXXXX", name="robot-01",
                        server="http://<your-relay>:8080")

seen = None
while True:
    v = robot.latest
    if v.cycle_id and v.cycle_id != seen:   # a new judged cycle
        seen = v.cycle_id
        if v.verdict == "fail":
            open_reject_bin(v.cycle_id)      # your action
        elif v.verdict == "success":
            pass_to_next_station(v.cycle_id)
    time.sleep(2)

curl -H "Authorization: Bearer ak_XXXXXXXXXXXXXXXX" \
  "http://<your-relay>:8080/v1/status?robot_name=robot-01"

import os, intuition
robot = intuition.Robot(api_key=os.environ["INTUITION_API_KEY"],
                        name="robot-01", server=os.environ["INTUITION_SERVER"])

try:
    robot.run()
except intuition.AuthError:
    print("bad key — copy the ak_ key again from the dashboard")
except intuition.ClaimError:
    print("cannot reach the cloud — check server= and your network")