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

# Manual Model Loading

> Deploy ASR models offline without HuggingFace downloads.

## Required Assets

Each ASR release ships four CoreML bundles plus vocabulary:

* `Preprocessor.mlmodelc`
* `Encoder.mlmodelc`
* `Decoder.mlmodelc`
* `JointDecision.mlmodelc`
* `parakeet_vocab.json`

## Directory Layout

```
/opt/models
└── parakeet-tdt-0.6b-v3-coreml
    ├── Preprocessor.mlmodelc
    ├── Encoder.mlmodelc
    ├── Decoder.mlmodelc
    ├── JointDecision.mlmodelc
    └── parakeet_vocab.json
```

## Download Options

1. **Git LFS clone:**
   ```bash theme={null}
   git lfs install
   git clone https://huggingface.co/FluidInference/parakeet-tdt-0.6b-v3-coreml
   ```
2. **HuggingFace web UI** — download `.tar` archives
3. **Copy from cache** — from a machine that already ran `downloadAndLoad` (macOS: `~/Library/Application Support/FluidAudio/Models/<repo>`)

## Loading Without Downloads

```swift theme={null}
import FluidAudio

let repoDirectory = URL(
    fileURLWithPath: "/opt/models/parakeet-tdt-0.6b-v3-coreml",
    isDirectory: true
)

let models = try await AsrModels.load(
    from: repoDirectory,
    configuration: AsrModels.defaultConfiguration(),
    version: .v3
)

let asrManager = AsrManager()
try await asrManager.initialize(models: models)
```

## Switching Versions

```swift theme={null}
let englishRepo = URL(fileURLWithPath: "/opt/models/parakeet-tdt-0.6b-v2-coreml")
let englishModels = try await AsrModels.load(from: englishRepo, version: .v2)
```

## Troubleshooting

* Use `AsrModels.modelsExist(at:)` to verify all bundles are present
* `parakeet_vocab.json` must sit beside the model bundles
* If you see `AsrModelsError.modelNotFound`, check folder names and `coremldata.bin` files