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 / 2

Requirements

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.

Related apps

Explore more like this

Explore all

Details

Repository
ghcr.io/frameleaf/frameleaf-machine-learning:latest
Last 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