Get involved
Contribute
Add a robot, fix a number, or give us a picture you own. Every record is one YAML file; adding or fixing one is a pull request, checked automatically against the schema.
Ways to contribute
Add a robot
Any robot that pushes or twists a catheter or guidewire, or a device that bends its own tip, with at least one paper or product page. Open an issue with the form below, or send the YAML file as a pull request.
Fix a record
A wrong number, a missing version, a newer test level: change the field, cite the source key and section in the text, open a pull request. Every robot page has a "Suggest a correction" link.
Give a picture
A photo of your own robot under CC BY 4.0 replaces a placeholder. State the licence and the credit line you want.
Improve the schema
Need a field or a vocabulary value that does not exist? Propose it in the same pull request as the record that needs it.
Repository: GitHub [repository not created yet]
Add or fix a record
- Copy the template below to
records/robots/<id>.yaml. The id is<shortname>_<firstauthor><year>in lower case, e.g.legobot_gao2026. - Fill the fields from the papers. Required:
schema_version,id,name,full_name,group,family,category,first_year,devices,translation_mechanism,rotation_mechanism,highest_validation,sim2real,picture,sources,read_level,maintainers_own. Vocabularies are listed in the docs. - Validate:
python3 tools/validate_records.py(needspip install pyyaml jsonschema). It exits non-zero and names the file and field on any error. - Preview:
python3 tools/build_site.py --public, thencd site && python3 -m http.server 8000and openhttp://localhost:8000. - Submit a pull request with the YAML file (and a picture in
records/pictures/if you own it). The repository's checks run the validator and build the site.
While the catalogue is generated from the review's CSV, a maintainer copies an accepted change into the CSV, so it survives the next build.
Record template
# records/robots/<id>.yaml — one file per robot. Text fields keep the sources' words; write N.R. when a
# source does not report it; never estimate a number. Check: python3 tools/validate_records.py
schema_version: 1
id: ''
name: ''
full_name: ''
group: ''
group_short: ''
# family: commercial | academic | tip | magnetic
family: ''
# category: commercial | clinical-stage | academic | actuated-device | magnetic-navigation
category: ''
first_year: null
latest_year: null
versions: ''
target_anatomy: ''
# devices: guidewire | microcatheter | catheter | sheath | therapeutic-device | other | not-reported
devices: []
devices_driven: ''
n_dof: null
n_dof_detail: ''
# translation_mechanism: friction-roller | clamp-relay | belt/track | linear-stage+clamp | magnetic | tendon/tip-actuation | other | not-reported
translation_mechanism: ''
translation_detail: ''
# rotation_mechanism: rotating-clamp | rotating-drive-unit | roller-rolling | handle-rotation | tendon-bending | magnetic-field | none | other | not-reported
rotation_mechanism: ''
rotation_detail: ''
device_range: ''
footprint_mm: ''
mass_kg: ''
force_sensing: ''
haptics_leader: ''
imaging_compat: ''
sterility: ''
# highest_validation: bench | phantom | ex-vivo | animal | human
highest_validation: ''
validation_detail: ''
key_numbers: ''
sim_model: ''
has_sim_model: false
# sim2real: yes | partial | model-based | unclear | none-found
sim2real: ''
sim2real_detail: ''
picture:
status: none # cleared | not-cleared | none
grade: none # A | B | C | none
kind: null # photo | render | product-photo | clinical-photo | drawing
source: '' # paper key + figure, or page URL
source_url: null
licence: ''
credit: ''
edits: ''
file: null # pictures/<id>.jpg, only when cleared
pictures: []
sources:
- key: firstauthor2026_word
doi: 10.xxxx/xxxxx
url: null
title: ''
year: 2026
venue: ''
# read_level: full | partial | abstract | web | secondary
read_level: ''
read_level_detail: ''
notes: ''
maintainers_own: false
# found_by: academic | commercial | actuated-tip | gap | contributor
found_by: ''
Field rules
- Write what the source says, in its units, with the source key and section:
stroke 300 mm (kantu2025_portable Sec. III-A). - A number the source does not report is
N.R.. Never estimate or convert a number the source did not give. - One record per robot line: later versions of the same robot go into
versions, oldest first. highest_validationis the highest level reached by any version, andvalidation_detailsays how many cases, animals or patients.sim2realisyesonly when a controller or model trained in simulation ran on this robot; cite the study.read_levelsays honestly how deep the reading went: full text, part of it, abstract, web page, or a secondary source.- Every paper in
sourceshas its DOI when one exists.
Pictures
A picture is published only when its licence allows reuse: Creative Commons
Attribution (CC BY, without NC, ND or SA) or material of the maintainers' own lab; the rule is
licence_ok() in tools/licence_rule.py. Any other picture (publisher copyright, press images,
NC/ND licences) stays at its source and the record links to it. Pictures are resized to 800 px on the long side;
list every change you made in picture.edits (CC BY asks for that).
Pull request checklist
- One robot per file; file name =
id+.yaml. python3 tools/validate_records.pypasses.- Every number has its source key and section; unreported values are
N.R.. - Every source has a DOI or a link.
- A picture, if added, is yours or CC BY, with
licence,creditandeditsfilled. - If you built the robot, say so in the pull request.
Issue form: new robot
The repository's issue form (.github/ISSUE_TEMPLATE/new-robot.yml)
asks for the following; by e-mail, the same list works.
Robot name and short description:
Developer (lab, university or company):
First paper (DOI) and later versions (DOIs):
Devices driven (guidewire / catheter / microcatheter / sheath / balloon-stent), sizes:
Push mechanism (friction rollers / clamp relay / belt / linear stage / magnetic / tip-actuated / other):
Twist mechanism:
Degrees of freedom:
Highest test level (bench / phantom / ex vivo / animal / human) and the paper that reports it:
A picture you own or one under CC BY (link and licence), if any:
Your relation to the robot (developer / user / reader):