termux-vision 1.4.2 → 1.4.3

package/README.md

@@ -60,8 +60,8 @@ pkg install -y python nodejs clang make cmake git termux-api wget vulkan-loader
 
 * **Option B: Direct GitHub Releases Wheel Asset (SSOT Verified)**:
   ```bash
-  # Download and install the prebuilt v1.4.1 release wheel
-  pip install https://github.com/uno-km/termux-vision/releases/download/v1.4.1/termux_vision-1.4.1-py3-none-any.whl
+  # Download and install the prebuilt v1.4.0 release wheel
+  pip install https://github.com/uno-km/termux-vision/releases/download/v1.4.0/termux_vision-1.4.0-py3-none-any.whl
   ```
 
 ### 2.3 Node.js / TypeScript CLI Installation

package/README.pypi.md

@@ -31,7 +31,7 @@ pip install termux-vision
 
 ### 2.2 Direct GitHub Releases Wheel Asset
 ```bash
-pip install https://github.com/uno-km/termux-vision/releases/download/v1.4.1/termux_vision-1.4.1-py3-none-any.whl
+pip install https://github.com/uno-km/termux-vision/releases/download/v1.4.0/termux_vision-1.4.0-py3-none-any.whl
 ```
 
 ### 2.3 One-Line Bootstrap Installer

package/lib/cache.js

@@ -24,7 +24,7 @@ const CATALOG = {
     adapter: 'smolvlm',
     tier: 'M',
     estimatedMemoryMb: 750,
-    contextLimit: 1024,
+    contextLimit: 2048,
     preferredResolution: 384,
     artifacts: [
       {
@@ -174,7 +174,7 @@ class ModelCacheManager {
           modelId: path.parse(filename).name,
           adapter: /smol/i.test(filename) ? 'smolvlm' : 'qwen2vl',
           tier: 'CUSTOM',
-          contextLimit: 1024
+          contextLimit: 2048
         },
         textModelPath: expanded,
         visionModelPath: visionPath
@@ -234,7 +234,7 @@ class ModelCacheManager {
         modelId: modelId,
         adapter: /smol/i.test(modelId) ? 'smolvlm' : 'qwen2vl',
         tier: 'CUSTOM',
-        contextLimit: 1024
+        contextLimit: 2048
       },
       textModelPath: textPath,
       visionModelPath: visionPath

package/lib/errors.js

@@ -86,9 +86,11 @@ class RuntimeNotFoundError extends TermuxVisionError {
       searched = '\n\nSearched paths:\n' + searchedPaths.map(p => `  - ${p}`).join('\n');
     }
     const msg =
-      `Required runtime 'llama-cli' was not found.${searched}\n\n` +
-      `Please ensure llama.cpp is installed on Termux:\n` +
-      `  pkg install termux-llamacpp  (or place llama-cli in PATH / $PREFIX/bin)`;
+      `Required runtime engine 'llama-cli' was not found.${searched}\n\n` +
+      `Please install the official termux-llamacpp native runtime:\n` +
+      `  - Python:  pip install termux-llamacpp\n` +
+      `  - Node.js: npm install -g termux-llamacpp\n` +
+      `  - Setup:   termux-llama install (compiles native binary if needed)`;
     super(msg);
     this.searchedPaths = searchedPaths;
   }

package/lib/vlm.js

@@ -284,17 +284,28 @@ class NodeVLMContext {
 
 async function load(options = {}) {
   const cache = new ModelCacheManager(options.cacheRoot || null);
-  const modelId = options.modelId || 'smolvlm-500m-q4';
 
-  if (!modelId || !String(modelId).trim()) {
-    throw new Error("Parameter 'modelId' cannot be null or empty.");
+  if (options.modelId && options.modelPath) {
+    throw new Error("Cannot specify both 'modelId' and 'modelPath'. Use 'modelId' for catalog presets or 'modelPath' for explicit .gguf file paths.");
   }
 
-  if (options.allowDownload && !cache.isModelInstalled(modelId)) {
-    await cache.install(modelId);
+  let modelInfo;
+  if (options.modelPath) {
+    const expanded = path.resolve(options.modelPath.replace(/^~(?=$|\/|\\)/, os.homedir()));
+    if (!fs.existsSync(expanded) || !fs.statSync(expanded).isFile()) {
+      throw new Error(`Model file not found at 'modelPath': ${options.modelPath}`);
+    }
+    modelInfo = cache.requireInstalledModel(expanded, options.mmprojPath || null);
+  } else {
+    const modelId = options.modelId || 'smolvlm-500m-q4';
+    if (!modelId || !String(modelId).trim()) {
+      throw new Error("Parameter 'modelId' cannot be null or empty.");
+    }
+    if (options.allowDownload && !cache.isModelInstalled(modelId)) {
+      await cache.install(modelId);
+    }
+    modelInfo = cache.requireInstalledModel(modelId, options.mmprojPath || null);
   }
-
-  const modelInfo = cache.requireInstalledModel(modelId, options.mmprojPath || null);
   const executable = resolveLlamaCli(options.runtimePath || null);
 
   const reqDevice = (options.device || 'auto').toLowerCase().trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termux-vision",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "On-device computer vision & VLM multimodal inference framework utilizing device resources for Android Termux & ARM64",
   "main": "index.js",
   "types": "index.d.ts",