> ## Documentation Index
> Fetch the complete documentation index at: https://docs.daydream.live/llms.txt
> Use this file to discover all available pages before exploring further.

# Using LoRAs

> Customize concepts and styles in your generations with LoRA adapters

# Using LoRAs in Scope

LoRA (Low-Rank Adaptation) adapters let you customize the concepts and styles used in your generations. You can install LoRAs from [HuggingFace](https://huggingface.co/) or [CivitAI](https://civitai.com/) directly from the app, load one or multiple at a time, and adjust their scale in real-time.

***

## Pipeline compatibility

Different pipelines support different LoRA model types. Make sure you download LoRAs that match your pipeline:

| Pipeline                         | Compatible LoRAs                                                                                     |
| -------------------------------- | ---------------------------------------------------------------------------------------------------- |
| StreamDiffusion V2               | Wan2.1-T2V-1.3B                                                                                      |
| LongLive                         | Wan2.1-T2V-1.3B                                                                                      |
| RewardForcing                    | Wan2.1-T2V-1.3B                                                                                      |
| MemFlow                          | Wan2.1-T2V-1.3B                                                                                      |
| Krea Realtime                    | Wan2.1-T2V-14B                                                                                       |
| [LTX 2.3](/scope/guides/ltx-2-3) | LTX 2.3 LoRAs (including [IC-LoRAs](/scope/reference/pipelines/ltx-2-3#ic-lora-catalog) and ID-LoRA) |

<Note>
  Krea Realtime uses the larger 14B model, so it requires different LoRAs than the other Wan2.1 pipelines.
</Note>

<Warning>
  LTX 2.3 only supports the **Permanent merge** strategy. Runtime PEFT is not available because the transformer is FP8 quantized. See the [LTX 2.3 guide](/scope/guides/ltx-2-3) for the full workflow.
</Warning>

***

## Recommended LoRAs

Here are some LoRAs to get you started:

### For 1.3B pipelines (StreamDiffusion V2, LongLive, RewardForcing, MemFlow)

<CardGroup cols={2}>
  <Card title="Arcane Jinx" icon="user" href="https://civitai.com/models/1332383/wan-lora-arcane-jinx-v1-wan-13b">
    Character LoRA for the Arcane art style
  </Card>

  <Card title="Genshin TCG" icon="cards" href="https://civitai.com/models/1728768/genshin-tcg-style-wan-13b">
    Stylized trading card game aesthetic
  </Card>
</CardGroup>

### For 14B pipeline (Krea Realtime)

<CardGroup cols={3}>
  <Card title="Origami" icon="paper-plane" href="https://huggingface.co/shauray/Origami_WanLora/tree/main">
    Paper-craft folded aesthetic
  </Card>

  <Card title="Film Noir" icon="film" href="https://huggingface.co/Remade-AI/Film-Noir">
    Classic black-and-white cinema style
  </Card>

  <Card title="Pixar" icon="clapperboard" href="https://huggingface.co/Remade-AI/Pixar">
    3D animated movie aesthetic
  </Card>
</CardGroup>

***

## Installing LoRAs

Scope has a built-in LoRA installer. You paste a URL from HuggingFace or CivitAI and the app downloads the file for you. This works for both local and [Remote Inference](/scope/guides/remote-inference) sessions.

<Steps>
  <Step title="Open settings">
    Click the **gear icon** (top-right) to open the Settings dialog.
  </Step>

  <Step title="Go to the LoRAs tab">
    Select the **LoRAs** tab on the left side of the Settings dialog.
  </Step>

  <Step title="Paste the URL">
    Copy the URL of a `.safetensors` file from HuggingFace or a LoRA model page from CivitAI. Paste it into the URL input field.
  </Step>

  <Step title="Click Install">
    Click **Install**. The file will download and appear in the **Installed LoRAs** list below.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/dd/iterITrYrYcGjvMP/images/scope/guides/loras/lora-settings-dialog.png?fit=max&auto=format&n=iterITrYrYcGjvMP&q=85&s=14273200b5f30d8b456482554196478a" alt="Settings LoRAs tab with URL input and installed LoRAs list" width="1188" height="704" data-path="images/scope/guides/loras/lora-settings-dialog.png" />
</Frame>

<Tip>
  Some LoRAs on HuggingFace or CivitAI may require authentication. If a download fails, go to **Settings** > **API Keys** and add your HuggingFace token or CivitAI API key. You can generate these from your account settings on each platform.
</Tip>

### Managing installed LoRAs

The **Installed LoRAs** section in the LoRAs tab shows all your downloaded LoRA files with their file sizes. From here you can:

* **Delete** a LoRA by clicking the trash icon next to it
* **Refresh** the list with the refresh button if you added files manually

LoRA files are stored at `~/.daydream-scope/models/lora/` and grouped by folder in the list.

<AccordionGroup>
  <Accordion title="Installing via terminal (RunPod)">
    If you have terminal access to a GPU machine (for example on RunPod), you can also download LoRAs manually using `wget`.

    ### From HuggingFace

    On the LoRA page, go to **Files and versions** and copy the link address for the `.safetensors` file.

    <video autoPlay muted loop playsInline className="w-full rounded-xl" src="https://mintcdn.com/dd/o3foaS1KQ94MP9Q1/images/scope/guides/loras/huggingface-copy-link.mp4?fit=max&auto=format&n=o3foaS1KQ94MP9Q1&q=85&s=45ed94f0470bc65757024679cb5b6a04" data-path="images/scope/guides/loras/huggingface-copy-link.mp4" />

    Then download it to the LoRA folder:

    ```bash theme={null}
    cd /workspace/models/lora
    wget -O <filename>.safetensors "<link_address>"
    ```

    **Example:**

    ```bash theme={null}
    wget -O pixar_10_epochs.safetensors "https://huggingface.co/Remade-AI/Pixar/resolve/main/pixar_10_epochs.safetensors?download=true"
    ```

    <Tip>
      On some RunPod templates, `wget` may not be pre-installed. If so, run `apt-get install wget` first.
    </Tip>

    ### From CivitAI

    CivitAI requires an API key for programmatic downloads.

    1. Create an account at [civitai.com](https://civitai.com)
    2. Go to [Developer Settings](https://developer.civitai.com/docs/getting-started/setup-profile)
    3. Generate an API key

    On the LoRA page, copy the download link address.

    <video autoPlay muted loop playsInline className="w-full rounded-xl" src="https://mintcdn.com/dd/o3foaS1KQ94MP9Q1/images/scope/guides/loras/civitai-copy-link.mp4?fit=max&auto=format&n=o3foaS1KQ94MP9Q1&q=85&s=0daf5ae12fe5726137748064ff7f034a" data-path="images/scope/guides/loras/civitai-copy-link.mp4" />

    Then download with your API token:

    ```bash theme={null}
    cd /workspace/models/lora
    wget -O <filename>.safetensors "<link_address>&token=<YOUR_API_KEY>"
    ```

    **Example:**

    ```bash theme={null}
    wget -O arcane-jinx.safetensors "https://civitai.com/api/download/models/1679582?type=Model&format=SafeTensor&token=YOUR_API_KEY"
    ```

    <Warning>
      Make sure to wrap the URL in double quotes - the `&` character will cause issues otherwise.
    </Warning>
  </Accordion>
</AccordionGroup>

***

## Configuring LoRAs

Once you have LoRAs installed, you can add them to your pipeline from the main interface. The LoRA Adapters dropdown shows LoRAs that have been installed through Settings or added manually to the `~/.daydream-scope/models/lora/` folder.

<Frame>
  <img src="https://mintcdn.com/dd/Cr3e7fjElaANYEpF/images/scope/guides/loras/lora-strategy-scale.png?fit=max&auto=format&n=Cr3e7fjElaANYEpF&q=85&s=1db5b3e475844821655a56b3dbcd7a35" alt="LoRA Adapters panel showing file picker, strategy dropdown, and scale slider" width="680" height="792" data-path="images/scope/guides/loras/lora-strategy-scale.png" />
</Frame>

<Steps>
  <Step title="Open the LoRA Adapters section">
    In the main Scope interface, find the **LoRA Adapters** section below the pipeline settings. If you don't see it, make sure your selected pipeline supports LoRAs (see the compatibility table above).
  </Step>

  <Step title="Add a LoRA">
    Click the **+** button to add a new LoRA slot. A dropdown will appear showing all your installed LoRA files. Select the one you want to use.
  </Step>

  <Step title="Choose a merge strategy">
    Each LoRA has a **Strategy** dropdown with two options:

    | Strategy            | Best for                             | Trade-off                                                             |
    | ------------------- | ------------------------------------ | --------------------------------------------------------------------- |
    | **Permanent merge** | Maximum FPS during generation        | Scale is fixed at pipeline load and cannot be changed while streaming |
    | **Runtime PEFT**    | Real-time tweaking during generation | Scale adjustable at any time, but up to \~50% FPS overhead            |
  </Step>

  <Step title="Set the scale">
    Use the **Scale** slider to control how much the LoRA affects your output. The range is -10 to +10, with 1.0 as the default. Higher values make the LoRA effect more pronounced.
  </Step>
</Steps>

You can add multiple LoRAs at the same time for combined effects. Click **+** again to add another slot.

<Warning>
  Many LoRAs require a **trigger keyword** in your prompt to activate. Check the LoRA's model page (on HuggingFace or CivitAI) for the required trigger phrase and include it in your prompt. For example, the Pixar LoRA uses the trigger `p1x4r_5ty13 Pixar animation style`.
</Warning>

<Note>
  You cannot add, remove, or switch LoRAs while a stream is running. Stop the generation first, make your changes, then press Play again. If you're using the **Runtime PEFT** strategy, you can adjust the scale slider while streaming.
</Note>

***

## Try community examples

Want to see LoRAs in action? Check out this walkthrough from the Community Hub:

<Card title="From Photorealistic to Pixar in Real-Time" icon="wand-magic-sparkles" href="https://app.daydream.live/creators/viborc/lora-adapters-in-scope-from-photorealistic-to-pixar-in-real-time?utm_source=docs&utm_medium=web&utm_campaign=docs2com">
  Watch how a single LoRA transforms a puppy scene from photorealistic to Pixar animation style using the Krea Realtime pipeline, with downloadable timeline files
</Card>

***

## Remote inference

LoRAs are fully supported with [Remote Inference](/scope/guides/remote-inference). When you install a LoRA while connected to a remote session, the file downloads directly to the cloud machine. Everything else works the same as local, including multiple LoRAs, scale adjustments, and merge strategies.

<Card title="Remote Inference" icon="cloud" href="/scope/guides/remote-inference">
  Learn how to run Scope on cloud-hosted GPUs without local hardware
</Card>

***

## See also

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/scope/getting-started/quickstart">
    Get Scope running if you haven't already
  </Card>

  <Card title="VACE Guide" icon="image" href="/scope/guides/vace">
    Use reference images to guide your generations
  </Card>
</CardGroup>
