MEYELens - Get Started

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 all the components and secure the fasteners.

Warning: In addition to the 3D-printed parts, you will need 7 M3 fasteners. Refer to the Fasteners section for details.

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.

Camera modules used in the system — Camera holder and camera module used in the system.

Camera mounted on the 3D-printed support — Secure the camera with two M2 screws and matching nuts.

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.

Command

pip install meyelens[pt]

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

Tip: For detailed installation instructions and advanced setup options, refer to the software page.

Warning: PyTorch may affect pupillometry performance. An incorrect PyTorch setup can reduce acquisition speed and negatively impact pupillary measurements. We strongly recommend a proper PyTorch installation, especially on systems equipped with an NVIDIA GPU.

07

Run your first test

Python


                                        from meyelens import meye, camera

                                        cam = camera.Camera(camera_index=0)
                                        meye = meye.Meye()

                                        meye.preview(cam)

This example initializes the camera and launches a live preview using MEYELens.

Tip: The software page provides detailed installation instructions, tutorials, and advanced configuration options.

Set up MEYELens in easy steps.