Argmax Local Server is now available!
Docs
Installation

Installation

This document is a step-by-step guide for integrating Argmax Pro SDK.

If you currently depend on Argmax Open-source SDK (e.g. WhisperKit), you will need to remove that dependency before you start.



Step 1: Set up SDK Access

Argmax Pro SDK Swift is delivered through Argmax's authenticated private Swift Package Manager (SwiftPM) registry.

You will need to execute two commands in your Terminal in order to set up your access.

Set up registry

swift package-registry set --global --scope argmaxinc https://api.argmaxinc.com/v1/sdk

Upon successful completion, your ~/.swiftpm/configuration/registries.json should look like this:

{
  "authentication": {},
  "registries": {
    "argmaxinc": {
      "supportsAvailability": false,
      "url": "https://api.argmaxinc.com/v1/sdk"
    }
  },
  "version": 1
}

Authenticate

swift package-registry login https://api.argmaxinc.com/v1/sdk/login --token <SECRET_API_TOKEN>

If you observe the following please reach out to Argmax:

Error: registry login using https://api.argmaxinc.com/v1/sdk/login failed: missing or invalid authentication credentials

Upon successful completion, you should see the following message in your Terminal:

Login successful.
Credentials have been saved to the operating system's secure credential store.
Registry configuration updated.

and your ~/.swiftpm/configuration/registries.json should look like this:

{
  "authentication": {
    "api.argmaxinc.com": {
      "loginAPIPath": "/v1/sdk/login",
      "type": "token"
    }
  },
  "registries": {
    "argmaxinc": {
      "supportsAvailability": false,
      "url": "https://api.argmaxinc.com/v1/sdk"
    }
  },
  "version": 1
}


Step 2: Add Argmax Pro SDK

If you are using the Package.swift file method, please add the following to that file:

dependencies: [
    .package(id: "argmaxinc.argmax-sdk-swift", upToNextMajor: "1.11.3"),
    ...
 ],
 ...
 targets: [
    .target(
        name: "YourTargetName",
        dependencies: [
	        .product(name: "Argmax", package: "argmaxinc.argmax-sdk-swift")
	      ],
        ...

If you are using an Xcode project, go to Package Dependencies > Add Package Dependencies and enter argmaxinc.argmax-sdk-swift in the Search or Enter Package URL field on the top right corner:

SDK Screen

After updating Package.swift or Xcode project, the Argmax package should appear along with the open-source dependencies (e.g. WhisperKit and swift-transformers) similar to the screenshot below:

Dependencies



Step 3: Initialize SDK

In order to unlock Pro features, you will first need to use your API key to initialize the SDK as follows:

import Argmax
...
let myAPIKey: String = "ax_..."
await ArgmaxSDK.with(ArgmaxConfig(apiKey: myAPIKey))

Please verify that your API key starts with ax_ and has exactly 34 characters. This key will be used to communicate with https://api.argmaxinc.com in order to verify the state of your subscription and provision a license for each device. Deidentified inference performance metrics will also be communicated as per argmaxinc.com/privacy.

Supported PlatformsManaging Models