explaingit

gainsec/autoprober

Analysis updated 2026-05-18

299PythonAudience · researcherComplexity · 5/5LicenseSetup · hard

TLDR

An AI agent controlled CNC rig that scans circuit boards with a microscope and safely probes chip pins for hardware security research.

Mindmap

mindmap
  root((AutoProber))
    What it does
      Scans circuit boards
      Maps pins and pads
      Probes approved targets
    Tech stack
      Python
      CNC controller
      Oscilloscope
    Use cases
      Hardware security research
      IoT reverse engineering
      Safety monitored probing
    Audience
      Security researchers
      Hardware hackers
      Embedded engineers

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 build with it?

USE CASE 1

Automatically map the pads, pins, and chips on an unfamiliar circuit board with a microscope.

USE CASE 2

Have an agent propose probe targets for a human to approve before any physical contact.

USE CASE 3

Probe individual pins on IoT or embedded devices for security research without manual guidance.

USE CASE 4

Monitor probe motion with an independent oscilloscope safety channel to prevent damage.

What is it built with?

PythonGRBLFlaskCNC

How does it compare?

gainsec/autoproberevolink-ai/awesome-blender-seedance-workflow-usecasestxbabaxyz/polyrec
Stars299295307
LanguagePythonPythonPython
Setup difficultyhardmoderatemoderate
Complexity5/53/53/5
Audienceresearcherdesignerresearcher

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

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires assembling specific physical hardware: a CNC controller, USB microscope, and an oscilloscope.

In plain English

AutoProber is a hardware hacking tool that uses an AI agent to automate the process of probing circuit boards. The problem it solves: when a security researcher wants to analyze the chips and pins on an unknown hardware device, like an IoT gadget, manually locating and physically touching tiny solder pads with a probe is slow and requires constant attention. AutoProber automates this by combining a small CNC machine, a USB microscope, and an oscilloscope into a single agent controlled system. Here is how it works: you place a target device on the CNC platform and tell the agent a new target is ready. The system uses the microscope to scan the board, takes a series of photos, identifies pads, pins, chips, and other features, then stitches those photos into an annotated map. It then presents proposed probe targets on a web dashboard for a human to approve or reject before anything physically touches the board. Once approved, the CNC arm moves the probe to make contact, and the oscilloscope measures the signal. A separate safety monitor checks continuously for unexpected contact, and if anything seems wrong, the machine stops immediately and waits for a human to clear the condition. You would use this if you are doing embedded security research or hardware reverse engineering and want to systematically probe unknown devices without manually guiding the probe by hand. It is written in Python and requires the specific physical hardware described in the project's bill of materials. The safety design is treated as a core part of the project rather than an afterthought, since the system moves physical hardware and could damage a device or itself if something goes wrong. The README explains that the probe pin itself is not trusted as a safety signal, and instead an independent oscilloscope channel is continuously watched during any motion, with any unexpected voltage or alarm forcing an immediate stop and a report to the operator rather than an automatic recovery attempt. All hardware, including the CNC motion, microscope, and oscilloscope, can also be controlled directly through the web dashboard or Python scripts, not only through the agent.

Copy-paste prompts

Prompt 1
Help me configure AutoProber's config/autoprober.example.env for my own lab hardware.
Prompt 2
Explain AutoProber's safety model and why Channel 4 monitoring is required during motion.
Prompt 3
Walk me through the flow from target detection to approved probe execution in AutoProber.
Prompt 4
What hardware do I need to buy to build my own AutoProber flying probe rig?
Prompt 5
How does AutoProber stitch microscope frames into an annotated target map?

Frequently asked questions

What is autoprober?

An AI agent controlled CNC rig that scans circuit boards with a microscope and safely probes chip pins for hardware security research.

What language is autoprober written in?

Mainly Python. The stack also includes Python, GRBL, Flask.

How hard is autoprober to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is autoprober for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.