Retina: Image Detection Skills
WARNING
Retina is not yet released.
This module is under active development and will be available in a future Telekinesis SDK release.
INFO
Retina is a module in the Telekinesis SDK containing skills for 2D object detection from images.
It provides detection capabilities using classical computer vision techniques, deep learning models, and modern foundation models, enabling reliable visual perception across a wide range of robotics applications.
When to Use Retina?
Use Retina when your robotics application relies on 2D visual detection from cameras, such as:
- Object detection for vision-guided manipulation
- Visual target identification for pick-and-place pipelines
- Perception for mobile robot navigation and obstacle awareness
- Visual inspection and monitoring in robotic systems
- Camera-based input for Physical AI agents
What Does Retina Provide?
Retina includes a collection of modular skills for:
- 2D object detection using classical vision algorithms
- Deep learning–based object detectors
- Foundation model–based and prompt-driven detection
- Image preprocessing and feature extraction for detection pipelines
How to Use Retina?
To use the skills from Retina, simply use:
python
import pathlib
from telekinesis import retina
from datatypes import io
DATA_DIR = pathlib.Path("path/to/telekinesis-data")
# Load image
filepath = str(DATA_DIR / "images" / "metal_gears.jpg")
image = io.load_image(filepath=filepath, as_gray=True)
# Detect circles
result = retina.detect_circle_using_classic_hough(
image=image,
inverse_resolution_ratio=1,
min_distance=50,
min_radius=40,
max_radius=60,
canny_detector_upper_threshold=300,
accumulator_threshold=30,
)
# Access results
annotations = result["annotations"].to_list()
logger.success(f"Detected {len(annotations)} circles using classic Hough transform.")Overview of Skills
Circle Detection
| SDK Call | Description |
|---|---|
| [detect_circle_using_classic_hough](/retina/detect circle using classic hough) | Detect circles using the classic Hough transform. |
| [detect_contours](/retina/detect contours) | Detect object outlines using a contour-based detector. |