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

# Quickstart

> Get started with NexaSdk in minutes.

## **Installation**

The NexaSdk for iOS/macOS can be downloaded directly from the official distribution link below.
Download [NexaSdk.xcframework](https://nexa-model-hub-bucket.s3.us-west-1.amazonaws.com/public/ios/latest/NexaSdk.xcframework.zip)

### **Add Dependency**

In Xcode, download and drag [NexaSdk.xcframework](https://nexa-model-hub-bucket.s3.us-west-1.amazonaws.com/public/ios/latest/NexaSdk.xcframework.zip) into your Project/Workspace.
Make sure the framework is added to the target's Frameworks, Libraries, and Embedded Content and set to Embed & Sign if you need the framework bundled in the app.

## **Run Your First Model**

<Steps>
  <Step title="Load Model">
    Create an ASR instance and load a model:

    ```swift theme={"dark"}
    import Foundation
    import NexaSdk

    let asr = try Asr(plugin: .ane)
    try await asr.load(from: "<path/to/model/dir>")
    ```
  </Step>

  <Step title="Transcribe Audio File">
    Use the loaded model to transcribe an audio file:

    ```swift theme={"dark"}
    let asrResponse = try await asr.transcribe(options: .init(audioPath: "<path/to/audio>"))
    print(asrResponse.asrResult.transcript)
    ```
  </Step>
</Steps>

<Note>
  **Load Model from HuggingFace**

  You can download models from the HuggingFace using the official [Hub](https://github.com/huggingface/swift-transformers) library and load them via the `load(from:)` API. For example:

  ```swift theme={"dark"}
  import Hub
  import NexaSdk

  let modelDir = try await Hub.snapshot(from: "NexaAI/parakeet-tdt-0.6b-v3-ane") { progress in
    print(progress.fractionCompleted)
  }
  let asr = try Asr(plugin: .ane)
  try await asr.load(from: modelDir)
  ```
</Note>

## **Supported Models**

Explore our curated collections of compatible models:

<CardGroup cols={2}>
  <Card title="ANE Models" icon="microchip" href="https://huggingface.co/collections/NexaAI/apple-neural-engine">
    Optimized models for Apple Neural Engine
  </Card>

  <Card title="GGUF Models" icon="file-code">
    Any GGUF format LLM and VLM models
  </Card>
</CardGroup>

## **Device Compatibility**

<AccordionGroup>
  <Accordion title="ANE Support" icon="microchip">
    * Apple Neural Engine
  </Accordion>

  <Accordion title="GPU/CPU Support" icon="memory">
    * arm64
  </Accordion>
</AccordionGroup>

## **Next Steps**

<Card title="API Reference" icon="book" href="/nexa-sdk-ios/APIReference">
  Explore detailed documentation for all model types and learn their usage.
</Card>

<br />

<div class="feedback-wrapper">
  <span class="feedback-label">Was this page helpful?</span>

  <div class="feedback-toggle">
    <input type="radio" name="feedback" id="feedback-yes" class="feedback-input" />

    <label for="feedback-yes" class="feedback-button">
      <img src="https://mintcdn.com/nexaai/g8-zBYnunEyVtcK3/Images/FeedBack/thumbs-up.svg?fit=max&auto=format&n=g8-zBYnunEyVtcK3&q=85&s=0b57c51c8db9940403e7552956e5c30e" alt="Thumbs up" class="feedback-icon" noZoom width="14" height="14" data-path="Images/FeedBack/thumbs-up.svg" />

      Yes
    </label>

    <input type="radio" name="feedback" id="feedback-no" class="feedback-input" />

    <label for="feedback-no" class="feedback-button">
      <img src="https://mintcdn.com/nexaai/g8-zBYnunEyVtcK3/Images/FeedBack/thumbs-down.svg?fit=max&auto=format&n=g8-zBYnunEyVtcK3&q=85&s=ebacf61d57c8259c6df243d329b548b3" alt="Thumbs down" class="feedback-icon" noZoom width="14" height="14" data-path="Images/FeedBack/thumbs-down.svg" />

      No
    </label>
  </div>
</div>
