FUSE - Mirage

Prerequisites

Python 3.11+
uv package manager (optional)

System FUSE

Install the OS-level FUSE kernel extension first:

macOS FUSE Setup, macFUSE + kernel extension + Apple Silicon recovery mode steps.
Linux FUSE Setup, fuse3 install and /etc/fuse.conf.

Install Mirage with the FUSE Extra

pip install "mirage-ai[fuse]"

Or with uv:

uv add "mirage-ai[fuse]"

Verify

from mirage import Workspace, MountMode
from mirage.resource.ram import RAMResource

with Workspace(
    {"/data": RAMResource()},
    mode=MountMode.WRITE,
    fuse=True,
) as ws:
    print("mountpoint:", ws.fuse_mountpoint)

If the printed path exists under /tmp/mirage-*, FUSE is wired up correctly.