cactus-react-native 1.10.0 → 1.10.1

package/README.md

@@ -1018,6 +1018,10 @@ Releases all resources associated with the model. Automatically calls `stop()` f
 
 Returns available models.
 
+**`getModelName(): string`**
+
+Returns the model slug or path the instance was created with.
+
 ### useCactusLM Hook
 
 The `useCactusLM` hook manages a `CactusLM` instance with reactive state. When model parameters (`model`, `corpusDir`, `cacheIndex`, `options`) change, the hook creates a new instance and resets all state. The hook automatically cleans up resources when the component unmounts.
@@ -1111,6 +1115,15 @@ Feeds audio samples into the streaming session and returns the current transcrip
 
 Stops the streaming session and returns the final confirmed transcription text. Throws an error if no session is active.
 
+**`detectLanguage(params: CactusSTTDetectLanguageParams): Promise<CactusSTTDetectLanguageResult>`**
+
+Detects the spoken language in the given audio. Automatically calls `init()` if not already initialized. Throws an error if a generation is already in progress.
+
+**Parameters:**
+- `audio` - Path to the audio file or raw PCM samples as a byte array.
+- `options`:
+  - `useVad` - Whether to apply VAD before detection (default: `true`).
+
 **`audioEmbed(params: CactusSTTAudioEmbedParams): Promise<CactusSTTAudioEmbedResult>`**
 
 Generates embeddings for the given audio file. Automatically calls `init()` if not already initialized. Throws an error if a generation is already in progress.
@@ -1134,6 +1147,10 @@ Releases all resources associated with the model. Stops any active streaming ses
 
 Returns available speech-to-text models.
 
+**`getModelName(): string`**
+
+Returns the model slug or path the instance was created with.
+
 ### useCactusSTT Hook
 
 The `useCactusSTT` hook manages a `CactusSTT` instance with reactive state. When model parameters (`model`, `options`) change, the hook creates a new instance and resets all state. The hook automatically cleans up resources when the component unmounts.
@@ -1216,6 +1233,10 @@ Releases all resources associated with the model. Safe to call even if the model
 
 Returns available VAD models.
 
+**`getModelName(): string`**
+
+Returns the model slug or path the instance was created with.
+
 ### useCactusVAD Hook
 
 The `useCactusVAD` hook manages a `CactusVAD` instance with reactive state. When model parameters (`model`, `options`) change, the hook creates a new instance and resets all state. The hook automatically cleans up resources when the component unmounts.
@@ -1314,6 +1335,20 @@ The `useCactusIndex` hook manages a `CactusIndex` instance with reactive state.
 - `compact(): Promise<void>` - Optimizes the index. Sets `isProcessing` to `true` during operation.
 - `destroy(): Promise<void>` - Releases all resources. Automatically called when the component unmounts.
 
+### getRegistry
+
+**`getRegistry(): Promise<{ [key: string]: CactusModel }>`**
+
+Returns all available models from HuggingFace, keyed by model slug. Result is cached across calls.
+
+```typescript
+import { getRegistry } from 'cactus-react-native';
+
+const registry = await getRegistry();
+const model = registry['qwen3-0.6b'];
+console.log(model.quantization.int4.url);
+```
+
 ## Type Definitions
 
 ### CactusLMParams
@@ -1647,6 +1682,32 @@ interface CactusSTTStreamTranscribeStopResult {
 }
 ```
 
+### CactusSTTDetectLanguageOptions
+
+```typescript
+interface CactusSTTDetectLanguageOptions {
+  useVad?: boolean;
+}
+```
+
+### CactusSTTDetectLanguageParams
+
+```typescript
+interface CactusSTTDetectLanguageParams {
+  audio: string | number[];
+  options?: CactusSTTDetectLanguageOptions;
+}
+```
+
+### CactusSTTDetectLanguageResult
+
+```typescript
+interface CactusSTTDetectLanguageResult {
+  language: string;
+  confidence?: number;
+}
+```
+
 ### CactusVADParams
 
 ```typescript

package/android/gradle.properties

@@ -2,4 +2,4 @@ Cactus_kotlinVersion=2.0.21
 Cactus_minSdkVersion=24
 Cactus_targetSdkVersion=34
 Cactus_compileSdkVersion=35
-Cactus_ndkVersion=27.1.12297006
+Cactus_ndkVersion=28.2.13676358

package/lib/module/index.js

@@ -12,5 +12,8 @@ export { useCactusSTT } from "./hooks/useCactusSTT.js";
 export { useCactusVAD } from "./hooks/useCactusVAD.js";
 export { useCactusIndex } from "./hooks/useCactusIndex.js";
 
+// Registry
+export { getRegistry } from "./modelRegistry.js";
+
 // Types
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["CactusLM","CactusSTT","CactusVAD","CactusIndex","useCactusLM","useCactusSTT","useCactusVAD","useCactusIndex"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA;AACA,SAASA,QAAQ,QAAQ,uBAAoB;AAC7C,SAASC,SAAS,QAAQ,wBAAqB;AAC/C,SAASC,SAAS,QAAQ,wBAAqB;AAC/C,SAASC,WAAW,QAAQ,0BAAuB;;AAEnD;AACA,SAASC,WAAW,QAAQ,wBAAqB;AACjD,SAASC,YAAY,QAAQ,yBAAsB;AACnD,SAASC,YAAY,QAAQ,yBAAsB;AACnD,SAASC,cAAc,QAAQ,2BAAwB;;AAEvD","ignoreList":[]}
+{"version":3,"names":["CactusLM","CactusSTT","CactusVAD","CactusIndex","useCactusLM","useCactusSTT","useCactusVAD","useCactusIndex","getRegistry"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA;AACA,SAASA,QAAQ,QAAQ,uBAAoB;AAC7C,SAASC,SAAS,QAAQ,wBAAqB;AAC/C,SAASC,SAAS,QAAQ,wBAAqB;AAC/C,SAASC,WAAW,QAAQ,0BAAuB;;AAEnD;AACA,SAASC,WAAW,QAAQ,wBAAqB;AACjD,SAASC,YAAY,QAAQ,yBAAsB;AACnD,SAASC,YAAY,QAAQ,yBAAsB;AACnD,SAASC,cAAc,QAAQ,2BAAwB;;AAEvD;AACA,SAASC,WAAW,QAAQ,oBAAiB;;AAE7C","ignoreList":[]}

package/lib/module/modelRegistry.js

@@ -1,10 +1,30 @@
 "use strict";
 
-const VERSION = 'v1.7';
+const RUNTIME_VERSION = '1.10.1';
 let registryPromise = null;
 export function getRegistry() {
   return registryPromise ??= fetchRegistry();
 }
+function parseVersionTag(tag) {
+  const m = tag.match(/^v(\d+)\.(\d+)(?:\.(\d+))?$/);
+  if (!m) return null;
+  return [+m[1], +m[2], +(m[3] ?? '0')];
+}
+function compareVersions(a, b) {
+  return a[0] - b[0] || a[1] - b[1] || a[2] - b[2];
+}
+async function resolveWeightVersion(modelId) {
+  const runtime = parseVersionTag(`v${RUNTIME_VERSION}`);
+  if (!runtime) throw new Error(`Invalid runtime version: ${RUNTIME_VERSION}`);
+  const res = await fetch(`https://huggingface.co/api/models/${modelId}/refs`);
+  if (!res.ok) throw new Error(`Failed to fetch refs for ${modelId}: ${res.status}`);
+  const {
+    tags = []
+  } = await res.json();
+  const compatible = tags.map(t => t.name).filter(name => parseVersionTag(name) !== null).filter(name => compareVersions(parseVersionTag(name), runtime) <= 0).sort((a, b) => compareVersions(parseVersionTag(b), parseVersionTag(a)));
+  if (!compatible.length) throw new Error('No compatible weight version found');
+  return compatible[0];
+}
 async function fetchRegistry() {
   const response = await fetch('https://huggingface.co/api/models?author=Cactus-Compute&full=true').catch(e => {
     registryPromise = null;
@@ -15,6 +35,11 @@ async function fetchRegistry() {
     throw new Error(`Failed to fetch model registry: ${response.status}`);
   }
   const models = await response.json();
+  if (!models.length) return {};
+  const version = await resolveWeightVersion(models[0].id).catch(e => {
+    registryPromise = null;
+    throw e;
+  });
   const registry = {};
   for (const {
     id,
@@ -23,7 +48,7 @@ async function fetchRegistry() {
     const weights = siblings.map(s => s.rfilename).filter(f => f.startsWith('weights/') && f.endsWith('.zip'));
     if (!weights.some(f => f.endsWith('-int4.zip')) || !weights.some(f => f.endsWith('-int8.zip'))) continue;
     const key = weights.find(f => f.endsWith('-int4.zip')).replace('weights/', '').replace('-int4.zip', '');
-    const base = `https://huggingface.co/${id}/resolve/${VERSION}/weights/${key}`;
+    const base = `https://huggingface.co/${id}/resolve/${version}/weights/${key}`;
     registry[key] = {
       quantization: {
         int4: {

package/lib/module/modelRegistry.js.map

@@ -1 +1 @@
-{"version":3,"names":["VERSION","registryPromise","getRegistry","fetchRegistry","response","fetch","catch","e","ok","Error","status","models","json","registry","id","siblings","weights","map","s","rfilename","filter","f","startsWith","endsWith","some","key","find","replace","base","quantization","int4","sizeMb","url","pro","apple","int8"],"sourceRoot":"../../src","sources":["modelRegistry.ts"],"mappings":";;AAEA,MAAMA,OAAO,GAAG,MAAM;AAEtB,IAAIC,eAA+D,GAAG,IAAI;AAE1E,OAAO,SAASC,WAAWA,CAAA,EAA4C;EACrE,OAAQD,eAAe,KAAKE,aAAa,CAAC,CAAC;AAC7C;AAEA,eAAeA,aAAaA,CAAA,EAA4C;EACtE,MAAMC,QAAQ,GAAG,MAAMC,KAAK,CAC1B,mEACF,CAAC,CAACC,KAAK,CAAEC,CAAC,IAAK;IACbN,eAAe,GAAG,IAAI;IACtB,MAAMM,CAAC;EACT,CAAC,CAAC;EACF,IAAI,CAACH,QAAQ,CAACI,EAAE,EAAE;IAChBP,eAAe,GAAG,IAAI;IACtB,MAAM,IAAIQ,KAAK,CAAC,mCAAmCL,QAAQ,CAACM,MAAM,EAAE,CAAC;EACvE;EAEA,MAAMC,MAAa,GAAG,MAAMP,QAAQ,CAACQ,IAAI,CAAC,CAAC;EAC3C,MAAMC,QAAwC,GAAG,CAAC,CAAC;EAEnD,KAAK,MAAM;IAAEC,EAAE;IAAEC,QAAQ,GAAG;EAAG,CAAC,IAAIJ,MAAM,EAAE;IAC1C,MAAMK,OAAiB,GAAGD,QAAQ,CAC/BE,GAAG,CAAEC,CAAM,IAAKA,CAAC,CAACC,SAAS,CAAC,CAC5BC,MAAM,CAAEC,CAAS,IAAKA,CAAC,CAACC,UAAU,CAAC,UAAU,CAAC,IAAID,CAAC,CAACE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAExE,IACE,CAACP,OAAO,CAACQ,IAAI,CAAEH,CAAC,IAAKA,CAAC,CAACE,QAAQ,CAAC,WAAW,CAAC,CAAC,IAC7C,CAACP,OAAO,CAACQ,IAAI,CAAEH,CAAC,IAAKA,CAAC,CAACE,QAAQ,CAAC,WAAW,CAAC,CAAC,EAE7C;IAEF,MAAME,GAAG,GAAGT,OAAO,CAChBU,IAAI,CAAEL,CAAC,IAAKA,CAAC,CAACE,QAAQ,CAAC,WAAW,CAAC,CAAC,CACpCI,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CACvBA,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;IAE3B,MAAMC,IAAI,GAAG,0BAA0Bd,EAAE,YAAYd,OAAO,YAAYyB,GAAG,EAAE;IAE7EZ,QAAQ,CAACY,GAAG,CAAC,GAAG;MACdI,YAAY,EAAE;QACZC,IAAI,EAAE;UACJC,MAAM,EAAE,CAAC;UACTC,GAAG,EAAE,GAAGJ,IAAI,WAAW;UACvB,IAAIZ,OAAO,CAACQ,IAAI,CAAEH,CAAC,IAAKA,CAAC,CAACE,QAAQ,CAAC,iBAAiB,CAAC,CAAC,GAClD;YAAEU,GAAG,EAAE;cAAEC,KAAK,EAAE,GAAGN,IAAI;YAAkB;UAAE,CAAC,GAC5C,CAAC,CAAC;QACR,CAAC;QACDO,IAAI,EAAE;UACJJ,MAAM,EAAE,CAAC;UACTC,GAAG,EAAE,GAAGJ,IAAI,WAAW;UACvB,IAAIZ,OAAO,CAACQ,IAAI,CAAEH,CAAC,IAAKA,CAAC,CAACE,QAAQ,CAAC,iBAAiB,CAAC,CAAC,GAClD;YAAEU,GAAG,EAAE;cAAEC,KAAK,EAAE,GAAGN,IAAI;YAAkB;UAAE,CAAC,GAC5C,CAAC,CAAC;QACR;MACF;IACF,CAAC;EACH;EAEA,OAAOf,QAAQ;AACjB","ignoreList":[]}
+{"version":3,"names":["RUNTIME_VERSION","registryPromise","getRegistry","fetchRegistry","parseVersionTag","tag","m","match","compareVersions","a","b","resolveWeightVersion","modelId","runtime","Error","res","fetch","ok","status","tags","json","compatible","map","t","name","filter","sort","length","response","catch","e","models","version","id","registry","siblings","weights","s","rfilename","f","startsWith","endsWith","some","key","find","replace","base","quantization","int4","sizeMb","url","pro","apple","int8"],"sourceRoot":"../../src","sources":["modelRegistry.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/src/index.d.ts

@@ -6,6 +6,7 @@ export { useCactusLM } from './hooks/useCactusLM';
 export { useCactusSTT } from './hooks/useCactusSTT';
 export { useCactusVAD } from './hooks/useCactusVAD';
 export { useCactusIndex } from './hooks/useCactusIndex';
+export { getRegistry } from './modelRegistry';
 export type { CactusModel, CactusModelOptions } from './types/common';
 export type { CactusLMParams, CactusLMDownloadParams, CactusLMMessage, CactusLMCompleteOptions, CactusLMTool, CactusLMCompleteParams, CactusLMCompleteResult, CactusLMTokenizeParams, CactusLMTokenizeResult, CactusLMScoreWindowParams, CactusLMScoreWindowResult, CactusLMEmbedParams, CactusLMEmbedResult, CactusLMImageEmbedParams, CactusLMImageEmbedResult, } from './types/CactusLM';
 export type { CactusSTTParams, CactusSTTDownloadParams, CactusSTTTranscribeOptions, CactusSTTTranscribeParams, CactusSTTTranscribeResult, CactusSTTAudioEmbedParams, CactusSTTAudioEmbedResult, CactusSTTStreamTranscribeStartOptions, CactusSTTStreamTranscribeProcessParams, CactusSTTStreamTranscribeProcessResult, CactusSTTStreamTranscribeStopResult, CactusSTTDetectLanguageOptions, CactusSTTDetectLanguageParams, CactusSTTDetectLanguageResult, } from './types/CactusSTT';

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,qCAAqC,EACrC,sCAAsC,EACtC,sCAAsC,EACtC,mCAAmC,EACnC,8BAA8B,EAC9B,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,qCAAqC,EACrC,sCAAsC,EACtC,sCAAsC,EACtC,mCAAmC,EACnC,8BAA8B,EAC9B,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cactus-react-native",
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "Run AI models locally on mobile devices",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/index.tsx

@@ -10,6 +10,9 @@ export { useCactusSTT } from './hooks/useCactusSTT';
 export { useCactusVAD } from './hooks/useCactusVAD';
 export { useCactusIndex } from './hooks/useCactusIndex';
 
+// Registry
+export { getRegistry } from './modelRegistry';
+
 // Types
 export type { CactusModel, CactusModelOptions } from './types/common';
 export type {

package/src/modelRegistry.ts

@@ -1,6 +1,6 @@
 import type { CactusModel } from './types/common';
 
-const VERSION = 'v1.7';
+const RUNTIME_VERSION = '1.10.1';
 
 let registryPromise: Promise<{ [key: string]: CactusModel }> | null = null;
 
@@ -8,6 +8,39 @@ export function getRegistry(): Promise<{ [key: string]: CactusModel }> {
   return (registryPromise ??= fetchRegistry());
 }
 
+function parseVersionTag(tag: string): [number, number, number] | null {
+  const m = tag.match(/^v(\d+)\.(\d+)(?:\.(\d+))?$/);
+  if (!m) return null;
+  return [+m[1]!, +m[2]!, +(m[3] ?? '0')];
+}
+
+function compareVersions(
+  a: [number, number, number],
+  b: [number, number, number]
+): number {
+  return a[0] - b[0] || a[1] - b[1] || a[2] - b[2];
+}
+
+async function resolveWeightVersion(modelId: string): Promise<string> {
+  const runtime = parseVersionTag(`v${RUNTIME_VERSION}`);
+  if (!runtime) throw new Error(`Invalid runtime version: ${RUNTIME_VERSION}`);
+
+  const res = await fetch(`https://huggingface.co/api/models/${modelId}/refs`);
+  if (!res.ok)
+    throw new Error(`Failed to fetch refs for ${modelId}: ${res.status}`);
+
+  const { tags = [] } = (await res.json()) as { tags: { name: string }[] };
+
+  const compatible = tags
+    .map((t) => t.name)
+    .filter((name) => parseVersionTag(name) !== null)
+    .filter((name) => compareVersions(parseVersionTag(name)!, runtime) <= 0)
+    .sort((a, b) => compareVersions(parseVersionTag(b)!, parseVersionTag(a)!));
+
+  if (!compatible.length) throw new Error('No compatible weight version found');
+  return compatible[0]!;
+}
+
 async function fetchRegistry(): Promise<{ [key: string]: CactusModel }> {
   const response = await fetch(
     'https://huggingface.co/api/models?author=Cactus-Compute&full=true'
@@ -21,6 +54,13 @@ async function fetchRegistry(): Promise<{ [key: string]: CactusModel }> {
   }
 
   const models: any[] = await response.json();
+  if (!models.length) return {};
+
+  const version = await resolveWeightVersion(models[0]!.id).catch((e) => {
+    registryPromise = null;
+    throw e;
+  });
+
   const registry: { [key: string]: CactusModel } = {};
 
   for (const { id, siblings = [] } of models) {
@@ -39,7 +79,7 @@ async function fetchRegistry(): Promise<{ [key: string]: CactusModel }> {
       .replace('weights/', '')
       .replace('-int4.zip', '');
 
-    const base = `https://huggingface.co/${id}/resolve/${VERSION}/weights/${key}`;
+    const base = `https://huggingface.co/${id}/resolve/${version}/weights/${key}`;
 
     registry[key] = {
       quantization: {