Watch frameleaf-ml video
Watch frameleaf-ml video
frameleaf-ml
frameleaf-ml
Docker app from Frameleaf's Repository
Overview
Find a photo by describing what you remember, and bring familiar faces together. This optional companion provides local machine learning for Frameleaf Server, including smart search and face recognition. The bundled Studio worker can also serve supported editing jobs when it shares its enrolment folder with the server.
Install alongside a running Frameleaf Server on the same frameleaf Docker network. It is a background worker with no separate web interface; browse your library and manage processing from Frameleaf. Keep the model cache persistent so models do not have to download again after every restart.
Model downloads need internet access and processing needs available CPU and memory. GPU use depends on a compatible image, drivers and device configuration; it is not enabled by this basic template. Mount the same Studio enrolment folder as the server, read-only here. Use Manager if you prefer guided installation and updates.
Media gallery
1 / 2Requirements
A compatible Frameleaf Server on the frameleaf Docker network; persistent model-cache storage; internet access for initial model downloads; sufficient CPU and memory for selected models. Studio worker enrolment requires the server shared folder mounted read-only. This template has no separate WebUI.
Categories
Related apps
Explore more like this
Explore allDetails
Repository
ghcr.io/frameleaf/frameleaf-machine-learning:latestLast Updated2026-11-11
First Seen2026-11-11
Runtime arguments
- Network
frameleaf- Shell
sh- Privileged
- false
Template configuration
Model cachePathrw
Persistent downloaded models
- Target
- /cache
- Default
- /mnt/user/appdata/frameleaf/model-cache
- Value
- /mnt/user/appdata/frameleaf/model-cache
Studio worker enrolmentPathro
The same folder as frameleaf-server's Studio worker enrolment, read-only; the bundled Studio render worker enrols from it. Set FRAMELEAF_STUDIO_WORKER=false to turn the worker off
- Target
- /run/frameleaf/studio-worker
- Default
- /mnt/user/appdata/frameleaf/studio-worker
- Value
- /mnt/user/appdata/frameleaf/studio-worker
Studio workerVariable
Run the bundled Studio render worker so web Studio opens and exports; false turns it off
- Target
- FRAMELEAF_STUDIO_WORKER
- Default
- true
- Value
- true