MEYELens open pupillometry & gaze tracking
Get Started

Set up MEYELens in easy steps.

Using MEYELens is easy. Follow these steps to build your complete 3D-printed platform for pupillometry and eye tracking.

01

Overview

MEYELens combines a modular 3D-printed eyewear with cost-effective cameras and an open workflow for acquisition and analysis. The setup follows three main steps: first, 3D print the headset components; second, assemble the hardware; and finally, set up and run the Python-based software pipeline.

Print the headset components using the provided 3D model files. The frame can be produced as a complete print or as individual parts, depending on the workflow you prefer and the level of post-processing you want.

The print has been tested and optimized for the Bambu Lab X1 Carbon 3D printer, but the models are compatible with other 3D printers and can be produced using standard printing settings.

Tip: You can find the 3D printing models and profiles here.
02

Print the parts

Print the frame components using the recommended settings for your 3D printer.

The complete set of 3D models and print files is available in the 3D models page, including a 3MF file containing the full print plate with all components and an optimized print profile for the eyewear platform.

Warning: Infill strongly affects both print time and mechanical strength. Lower values (e.g., 15%) reduce printing time but produce fragile parts with limited durability. A recommended compromise is around 50%, which provides a good balance between print speed, strength, and long-term reliability.
3D printing time lapse.
03

Assemble the headset

Assemble the structural components, mount the supports, and secure the fasteners.

  1. Prepare the printed frame components, screws, and nuts.
  2. Mount the arms and structural supports onto the frame.
  3. Attach the camera holder to the designated mount.
  4. Secure the screws and nuts using a small amount of light-curing adhesive.
Short assembly demonstration.
Warning: Use sandpaper if a printed part feels too tight in its intended position. Because of normal 3D-printing tolerances, some components may require minor finishing before assembly. Light sanding is usually enough to improve the fit.
04

Mount the camera(s)

After assembling the frame, mount the camera module(s) and secure them using the appropriate screws.

Components

  • 3D-printed Camer Holder
  • M2 screws and nuts
  • Eye-facing camera module (required)
  • World-facing camera module (optional)
  • USB cables routed through the dedicated channels
Camera modules used in the system
Camera holder and camera module used in the system.
Camera mounted on the 3D-printed support
Example of the camera mounted on the holder.
Tip: You can find other details on the possible hardware configurations on the hardware page.
05

Install the software

Set up the Python environment and install the required package.

pip install meyelens[tf]

This command installs the MEYELens Python package (including TensorFlow), providing access to the full acquisition and analysis pipeline.

Tip: For detailed installation instructions and advanced setup options, refer to the software page.
Warning: TensorFlow may affect pupillometry performance. An incorrect TensorFlow setup can reduce acquisition speed and negatively impact pupillary measurements. We strongly recommend a proper TensorFlow installation, especially on systems equipped with an NVIDIA GPU.
07

Run your first recording

Test the system with a short acquisition and confirm that the output is valid.

Before starting

  • Confirm camera detection
  • Check illumination
  • Verify framing of the eye

Expected outputs

  • Video recording
  • CSV export
  • Optional QC overlay