apriltag-recognizer/README.md

AprilTag Recognizer

A small python program that uses syndicate-py to run an OpenCV + apriltag detector thread and asserts any apriltag detections to a Dataspace

Demo

A demo program for listening to the apriltag assertions is included in listener.py

To run the full demo, first start a Dataspace. I use the syndicate-server. You can install this dataspace server impl using the following commands:

git clone https://git.syndicate-lang.org/syndicate-lang/syndicate-rs
cd syndicate-rs
cargo build --release
./target/release/syndicate-server -c dev-scripts/benchmark-config.pr

In a new terminal, run the recognizer NOTE: This will open your webcam if available!

python3 apriltag.py

Then in yet another terminal, run the listener:

python3 listener.py

Now when you put a tagStandard52h13 apriltag in webcam range, the recognizer should start asserting the tag's location. If you do not have a printer available, I found it's easy to simply navagate to the apriltag website on a mobile device, zoom in on the tagStandard25h13 tag on the homepage and hold your phone screen to the camera.