> ## Documentation Index
> Fetch the complete documentation index at: https://struktoai-fix-databricks-volume-token-provider.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# FUSE

> Set up FUSE support for MIRAGE in Python.

## Prerequisites

* Python 3.11+
* [uv](https://docs.astral.sh/uv/) package manager (optional)

## System FUSE

Install the OS-level FUSE kernel extension first:

* [macOS FUSE Setup](/home/setup/macos), macFUSE + kernel extension + Apple Silicon recovery mode steps.
* [Linux FUSE Setup](/home/setup/linux), `fuse3` install and `/etc/fuse.conf`.

## Install Mirage with the FUSE Extra

```bash theme={null}
pip install "mirage-ai[fuse]"
```

Or with uv:

```bash theme={null}
uv add "mirage-ai[fuse]"
```

## Verify

```python theme={null}
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.