Skip to main content

Models and media

Note
Add-ons need a development build or a release newer than 4.12.1.

These add-ons are pages for working with models and media. The routes that they call stay in LocalAI.

  • Studio

    In the current development builds, this add-on is in the development channel of the add-on library, so it can change. At a glance Topic Detail What it adds A page to make images, video, 3D models, speech, sound and transformed audio with the models you have installed, and to keep what you make. Who installs it An administrator, from Add-ons, Find add-ons, with Install and turn on. With authentication off, you are the administrator. Who turns it on A person needs the addons feature, which is off by default for new users on a server with accounts. The page opens at /app/addons/studio/studio. Note Studio is an add-on. It is not part of the web bundle: install it from Find add-ons in the Add-ons page with Install and turn on. Once it is usable, it is in My add-ons and can be shown in the sidebar, and it opens at /app/addons/studio/studio. Use its canonical add-on page address.

  • Talk

    Have a spoken conversation with a model: your voice goes in, the answer is spoken back.

  • Voice

    Recognise who is speaking, keep the voices that text to speech can use, and speak text with them.

  • Face

    Find out whose face is in a photo, or whether two photos show the same person.

  • Fine-tuning

    Train an adapter on your own data, then export it as a model you can chat with.

  • Quantization

    Shrink a model to a smaller quantized file, then import it so you can chat with it.

Subsections of Models and media

Studio

Note
Add-ons need a development build or a release newer than 4.12.1.

In the current development builds, this add-on is in the development channel of the add-on library, so it can change.

At a glance

TopicDetail
What it addsA page to make images, video, 3D models, speech, sound and transformed audio with the models you have installed, and to keep what you make.
Who installs itAn administrator, from Add-ons, Find add-ons, with Install and turn on. With authentication off, you are the administrator.
Who turns it onA person needs the addons feature, which is off by default for new users on a server with accounts. The page opens at /app/addons/studio/studio.
Note

Studio is an add-on. It is not part of the web bundle: install it from Find add-ons in the Add-ons page with Install and turn on. Once it is usable, it is in My add-ons and can be shown in the sidebar, and it opens at /app/addons/studio/studio. Use its canonical add-on page address.

Studio is the part of the web UI where you make images, video, 3D objects, speech, sound and transformed audio, and find what you made before. It opens on a front page with a prompt box and your own work. Each type still has its own workspace page (Images, Video, 3D, TTS, Sound, Transform, Diarization) where a run happens.

Make something

Type what you want in the box under What do you want to make?, or pick a type first. The box suggests a type from your words (“Sounds like Video”) and never switches by itself. The suggestion is a short list of keywords in the browser. No model is called.

KeyAction
/Focus the prompt box
Alt+1 to Alt+7Pick a type, in the order of the chips
Ctrl+Enter (Cmd+Enter)Generate
Alt+EnterTake the suggested type
EscClose the details in a lineage view

Generate opens the workspace for the chosen type with the prompt, the model, and the options that workspace has already filled in: size and count for Images, size for Video. The run itself happens on the workspace page, as before. The front page does not run anything.

3D, Transform and Diarization start from a file. Use the Start from list to pick one of your earlier results as the file, or add a file on the next page.

A type with no model

A type with no installed model is a dashed chip. Picking it shows one model from the gallery, its download size and memory need where the gallery knows them, the memory free now, and an Install button. Nothing installs until you press it, and the words you typed stay in the box while it installs. When the gallery gives no size, the note says so.

Your work

Your work lists the results this browser has a record of, newest first, with filters for each type and counts. Each tile shows a thumbnail (a waveform drawing for audio, one bar per speaker for diarization), the prompt, the model and the age. The star marks a favourite.

Results made from each other stack into one project tile. Open a tile to see the lineage.

Where the history is kept

The history lives in your browser, not on the server. Each workspace writes its own list when a result is produced: images, video, TTS, sound and audio transform in browser storage (up to 100 entries each), 3D in IndexedDB (up to 20 entries, with the model file), and diarization in browser storage with the file name, the model and the speaker count only. It never keeps the recording or the transcript. A prompt longer than 2000 characters is cut when it is stored. Favourites are a list of up to 500 ids.

Results made before this version have no link to the result they came from, so they appear as single tiles. The files themselves are on the server; if the server has cleaned its output folder, the tile shows the type icon instead of a picture.

Clear history removes all of these lists and the favourites from this browser after a confirmation. It does not delete files on the server.

Lineage

When a workspace is opened from a result (for example Animate on a picture), the new result records the id of the result it came from and how: take, animate, to 3D, variation, transform or who spoke. The lineage view draws those links as a board: prompts or files on the left, results next to them, the path through the selected result drawn heavier, and one dashed suggested next step chosen from the installed models.

The dock under the board acts on the selected result:

  • Run as a new take opens the same workspace with the prompt, model and size filled in. It is disabled when the original input was not kept (3D, diarization).
  • Branch from here opens a draft: choose the next step, edit the words, and Open in the workspace with the result as its starting point.

A step is listed but disabled, with the reason, when the destination page cannot start from that kind of result yet. Today a video cannot start a sound and a 3D object cannot start a clip.

Arrow keys walk the board, B branches and Esc closes the draft, then the details, then the view.

The workspace page

All seven workspaces share one layout, under a row of tabs, one per type:

  • Compose card. Optional sources as dashed chips (a start image, reference images, an end image, avatar audio), or a drop area where the run cannot start without a file (a recording for Diarization, audio for Transform, a picture for 3D). Then the prompt, with starters while it is empty, a model chip, the essential options as chips (size and count, duration and frame rate, voice, mode), and an Advanced fold that names what is inside when it is closed. Below that: the memory the model needs and whether it fits, when the gallery knows it, and one button. When the button cannot run, the reason is next to it. With no model for the type, the install note from the front page shows in the card.
  • Run area. While a request is out, a job card shows the model and options and the time that has passed. The server reports no phase and no percentage on these endpoints, so the bar is indeterminate. A failed run shows what the server said, says the prompt and settings are still there, and offers Try again. A finished run shows the result in a viewer for its type (picture grid, video player, waveform player, 3D viewer, spectrograms, or a timeline of speakers) with a toolbar:
    • Favourite, the same list the front page keeps.
    • Download.
    • Use in lists where the result can go next. A step is disabled, with the reason, when the destination cannot start from it, or when no model for it is installed it says so.
    • Re-run with edits puts the result’s values back in the form. The fields you then change are outlined and listed under Changed from this take, and the button reads Run again. It is disabled when the original input was not kept (3D, diarization).
    • Lineage opens the lineage view of the front page for this result.
  • Recent results. A strip of the results of this type from the same history, with an All and a Favourites filter. Click a tile to show it above, and click it again to go back to the latest.

Diarization lists who spoke when as one lane per speaker, the talk time of each speaker, and the segments with their text when the model returned it. RTTM, SRT (only when there is text) and JSON are built in the browser from the result in hand.

What a workspace accepts from the front page

The workspaces read these query parameters, so a link of your own works too: prompt, model, size, n (count), from (the id of the result it starts from) and edge (how). For example /app/addons/studio/studio/video?prompt=Slow%20push-in&from=<id>&edge=animate.

Talk

Note
Add-ons need a development build or a release newer than 4.12.1.

The Talk add-on (ID talk) is a page for a spoken conversation with a model. It is separate from Studio. In the current development builds, it is in the development channel of the add-on library, so it can change.

At a glance

TopicDetail
What it addsThe page /app/addons/talk/talk. It opens a WebRTC session to a realtime pipeline through /v1/realtime/calls and reads the pipeline list from /api/pipeline-models, with your own session. It uses the MCP servers that you added in the browser.
Who installs itAn administrator, from Add-ons, Find add-ons, with Install and turn on. With authentication off, you are the administrator.
Who turns it onA person needs the addons feature. It is off by default for new users on a server with accounts. The core keeps the two routes and checks every call.
GuideRealtime API and The Talk add-on in the contract reference

Voice

Note
Add-ons need a development build or a release newer than 4.12.1.

The Voice add-on (ID voice) is the page for voice recognition, the voice library and text to speech. It is separate from the Face add-on. In the current development builds, it is in the development channel of the add-on library, so it can change.

At a glance

TopicDetail
What it addsOne page, /app/addons/voice/voice, with four tabs: Recognition, Library, Text to speech and From a recording. The Library tab is for administrators.
Who installs itAn administrator, from Add-ons, Find add-ons, with Install and turn on. With authentication off, you are the administrator.
Who turns it onA person needs the addons feature (off by default for new users on a server with accounts). The Recognition tab also needs the voice_recognition feature, which is on by default. The routes stay in the core and are checked on every call.
GuideVoice Recognition

Face

Note
Add-ons need a development build or a release newer than 4.12.1.

The Face add-on (ID face) is the page for face recognition. It is separate from the Voice add-on. In the current development builds, it is in the development channel of the add-on library, so it can change.

At a glance

TopicDetail
What it addsOne page, /app/addons/face/recognition: who is this, same person, and the faces you enrolled. The detect and embedding tools are under More tools.
Who installs itAn administrator, from Add-ons, Find add-ons, with Install and turn on. With authentication off, you are the administrator.
Who turns it onA person needs the addons feature (off by default for new users on a server with accounts). The page also needs the face_recognition feature, which is on by default. The routes stay in the core and are checked on every call.
GuideFace Recognition

Fine-tuning

Note
Add-ons need a development build or a release newer than 4.12.1.

The Fine-tuning add-on (ID fine-tuning) is the Fine-Tune page and the chat tools for fine-tuning jobs. The API and the training backends are part of LocalAI. In the current development builds, it is in the development channel of the add-on library, so it can change.

At a glance

TopicDetail
What it addsThe page /app/addons/fine-tuning/jobs and chat tools: list jobs, propose a job, store a small dataset, read the status and the checkpoints of a job, stop a job and export a checkpoint as a model.
Who installs itAn administrator, from Add-ons, Find add-ons, with Install and turn on. With authentication off, you are the administrator.
Who turns it onA person needs the addons feature and the fine_tuning feature. Both are off by default for new users on a server with accounts. With --addons-enabled=false this feature is off.
GuideFine-tune a model

This feature is experimental and may change.

Quantization

Note
Add-ons need a development build or a release newer than 4.12.1.

The Quantization add-on (ID quantization) is the Quantize page and the chat tools for quantization jobs. The API and the quantization backend are part of LocalAI. In the current development builds, it is in the development channel of the add-on library, so it can change.

At a glance

TopicDetail
What it addsThe page /app/addons/quantization/jobs and chat tools: list jobs, propose a job, read the status of a job, stop a job and import the result as a model.
Who installs itAn administrator, from Add-ons, Find add-ons, with Install and turn on. With authentication off, you are the administrator.
Who turns it onA person needs the addons feature and the quantization feature. Both are off by default for new users on a server with accounts. With --addons-enabled=false this feature is off.
GuideQuantize a model

This feature is experimental and may change.