termux-vision 1.7.0 → 1.8.0

package/README.md

@@ -72,8 +72,8 @@ pkg install -y python nodejs clang make cmake git termux-api wget vulkan-loader
 
 * **Option C: Direct GitHub Releases Wheel Asset**:
   ```bash
-  # Download and install the prebuilt v1.6.0 release wheel
-  pip install https://github.com/uno-km/termux-vision/releases/download/v1.6.0/termux_vision-1.6.0-py3-none-any.whl
+  # Download and install the prebuilt v1.5.0 release wheel
+  pip install https://github.com/uno-km/termux-vision/releases/download/v1.5.0/termux_vision-1.5.0-py3-none-any.whl
   ```
 
 ### 2.3 Node.js / TypeScript CLI Installation
@@ -281,49 +281,6 @@ termux-vision doctor
 
 ---
 
-## Distributed Clustering & Memory Pooling (AMEVA-Cluster)
-
-Termux-Vision integrates with **AMEVA-Cluster** (`pip install ameva-cluster`) for distributed multimodal VLM inference across interconnected mobile fleets.
-
-### 1. Install Cluster Runtime
-```bash
-pip install ameva-cluster
-# or Node.js:
-npm install @ameva/cluster
-```
-
-### 2. Launch Worker Node on Remote Phone
-```bash
-# On remote worker device (e.g. Galaxy A53):
-ameva-cluster worker --port 50052
-```
-
-### 3. Distributed VLM Image Analysis
-```bash
-# Master node running VLM inference sharded across remote phone RAM:
-termux-vision analyze \
-  --model Qwen2.5-VL-7B-Instruct-Q4_K_M.gguf \
-  --mmproj mmproj-Qwen2.5-VL-7B.gguf \
-  --image scene.jpg \
-  --rpc 192.0.2.10:50052,192.0.2.11:50052 \
-  -p "Detailed description of all objects in this image."
-```
-
-```python
-from termux_vision import vlm
-
-# Python SDK Distributed VLM
-engine = vlm.load(
-    "Qwen2.5-VL-7B-Instruct-Q4_K_M.gguf",
-    mmproj="mmproj-Qwen2.5-VL-7B.gguf",
-    cluster_rpc_servers="192.0.2.10:50052,192.0.2.11:50052"
-)
-res = engine.generate("scene.jpg", prompt="Describe the image.")
-print(res.text)
-```
-
----
-
 ## 9. Hardware Requirements & Operational Limits
 
 | Requirement | Minimum Specification | Recommended Specification |

package/README.pypi.md

@@ -39,7 +39,7 @@ termux-vision install
 
 ### 2.3 Direct GitHub Releases Wheel Asset
 ```bash
-pip install https://github.com/uno-km/termux-vision/releases/download/v1.6.0/termux_vision-1.6.0-py3-none-any.whl
+pip install https://github.com/uno-km/termux-vision/releases/download/v1.5.0/termux_vision-1.5.0-py3-none-any.whl
 ```
 
 ### 2.4 One-Line Bootstrap Installer

package/bin/cli.js

@@ -1,4 +1,8 @@
 #!/usr/bin/env node
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
 /**
  * AMEVA Standard Node.js CLI Runner for termux_vision.
  * Automatically resolves Python 3 environment and dispatches to python -m termux_vision.

package/index.d.ts

@@ -1,97 +1,101 @@
-/**
- * Type declarations for termux-vision Node.js SDK
- */
-
-export interface VLMDescribeOptions {
-  prompt?: string;
-  maxTokens?: number;
-  temperature?: number;
-}
-
-export interface InferenceMetrics {
-  backend: string;
-  modelId: string;
-  decodeMs: number;
-  tokensPerSecond?: number;
-}
-
-export interface VLMResult {
-  text: string;
-  finishReason: string;
-  wordCount: number;
-  metrics: InferenceMetrics;
-  warnings: string[];
-}
-
-export interface VLMContext {
-  describe(imagePath: string, options?: VLMDescribeOptions): Promise<VLMResult>;
-  ask(imagePath: string, question: string): Promise<string>;
-  close(): void;
-}
-
-export interface LoadOptions {
-  modelId?: string;
-  device?: 'auto' | 'cpu' | 'vulkan' | 'gpu' | 'vulkan-force';
-  threads?: number | 'auto';
-  runtimePath?: string;
-  mmprojPath?: string;
-  allowDownload?: boolean;
-}
-
-export interface DiagnosticReport {
-  schemaVersion: number;
-  platform: {
-    system: string;
-    machine: string;
-    isAndroid: boolean;
-  };
-  hardware: {
-    cpuCores: number;
-    totalRamMb: number | null;
-    availableRamMb: number | null;
-  };
-  vulkan: {
-    loaderDetected: boolean;
-    driverDetected: boolean;
-    status: string;
-  };
-  modelsCount: number;
-}
-
-export interface ModelInfo {
-  modelId: string;
-  tier: string;
-  state: string;
-  sizeMb: number;
-  path: string;
-}
-
-export namespace vlm {
-  export function load(options?: LoadOptions): Promise<VLMContext>;
-}
-
-export namespace cache {
-  export function listInstalled(): ModelInfo[];
-  export function install(modelId: string, onProgress?: (file: string, downloaded: number, total: number) => void): Promise<void>;
-  export function remove(modelId: string): boolean;
-}
-
-export namespace doctor {
-  export function run(probeVulkan?: boolean): DiagnosticReport;
-}
-
-export namespace cv {
-  export function canny(grayPixels: Uint8Array, width: number, height: number, low?: number, high?: number): Uint8Array;
-  export function sobel(grayPixels: Uint8Array, width: number, height: number): { gradX: Float32Array; gradY: Float32Array; magnitude: Float32Array };
-}
-
-export namespace detect {
-  export interface BBox {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    score?: number;
-  }
-  export function nms(boxes: BBox[], iouThreshold?: number): BBox[];
-}
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+/**
+ * Type declarations for termux-vision Node.js SDK
+ */
+
+export interface VLMDescribeOptions {
+  prompt?: string;
+  maxTokens?: number;
+  temperature?: number;
+}
+
+export interface InferenceMetrics {
+  backend: string;
+  modelId: string;
+  decodeMs: number;
+  tokensPerSecond?: number;
+}
+
+export interface VLMResult {
+  text: string;
+  finishReason: string;
+  wordCount: number;
+  metrics: InferenceMetrics;
+  warnings: string[];
+}
+
+export interface VLMContext {
+  describe(imagePath: string, options?: VLMDescribeOptions): Promise<VLMResult>;
+  ask(imagePath: string, question: string): Promise<string>;
+  close(): void;
+}
+
+export interface LoadOptions {
+  modelId?: string;
+  device?: 'auto' | 'cpu' | 'vulkan' | 'gpu' | 'vulkan-force';
+  threads?: number | 'auto';
+  runtimePath?: string;
+  mmprojPath?: string;
+  allowDownload?: boolean;
+}
+
+export interface DiagnosticReport {
+  schemaVersion: number;
+  platform: {
+    system: string;
+    machine: string;
+    isAndroid: boolean;
+  };
+  hardware: {
+    cpuCores: number;
+    totalRamMb: number | null;
+    availableRamMb: number | null;
+  };
+  vulkan: {
+    loaderDetected: boolean;
+    driverDetected: boolean;
+    status: string;
+  };
+  modelsCount: number;
+}
+
+export interface ModelInfo {
+  modelId: string;
+  tier: string;
+  state: string;
+  sizeMb: number;
+  path: string;
+}
+
+export namespace vlm {
+  export function load(options?: LoadOptions): Promise<VLMContext>;
+}
+
+export namespace cache {
+  export function listInstalled(): ModelInfo[];
+  export function install(modelId: string, onProgress?: (file: string, downloaded: number, total: number) => void): Promise<void>;
+  export function remove(modelId: string): boolean;
+}
+
+export namespace doctor {
+  export function run(probeVulkan?: boolean): DiagnosticReport;
+}
+
+export namespace cv {
+  export function canny(grayPixels: Uint8Array, width: number, height: number, low?: number, high?: number): Uint8Array;
+  export function sobel(grayPixels: Uint8Array, width: number, height: number): { gradX: Float32Array; gradY: Float32Array; magnitude: Float32Array };
+}
+
+export namespace detect {
+  export interface BBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    score?: number;
+  }
+  export function nms(boxes: BBox[], iouThreshold?: number): BBox[];
+}

package/index.js

@@ -1,32 +1,36 @@
-/**
- * termux-vision: Native On-Device Computer Vision & VLM Multimodal Inference Framework.
- * Dual-Engine (Python & Node.js/TypeScript) Native Module for Android Termux & ARM64.
- * Open-Source under Apache License 2.0.
- */
-
-'use strict';
-
-const errors = require('./lib/errors');
-const cache = require('./lib/cache');
-const vlm = require('./lib/vlm');
-const doctor = require('./lib/doctor');
-const cv = require('./lib/cv');
-const detect = require('./lib/detect');
-
-const packageJson = require('./package.json');
-const version = packageJson.version;
-const cacheManager = new cache.ModelCacheManager();
-cacheManager.ModelCacheManager = cache.ModelCacheManager;
-
-module.exports = {
-  version,
-  __version__: version,
-  errors,
-  cache: cacheManager,
-  ModelCacheManager: cache.ModelCacheManager,
-  vlm,
-  load: vlm.load,
-  doctor: doctor.runDoctor,
-  cv,
-  detect
-};
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+/**
+ * termux-vision: Native On-Device Computer Vision & VLM Multimodal Inference Framework.
+ * Dual-Engine (Python & Node.js/TypeScript) Native Module for Android Termux & ARM64.
+ * Open-Source under Apache License 2.0.
+ */
+
+'use strict';
+
+const errors = require('./lib/errors');
+const cache = require('./lib/cache');
+const vlm = require('./lib/vlm');
+const doctor = require('./lib/doctor');
+const cv = require('./lib/cv');
+const detect = require('./lib/detect');
+
+const packageJson = require('./package.json');
+const version = packageJson.version;
+const cacheManager = new cache.ModelCacheManager();
+cacheManager.ModelCacheManager = cache.ModelCacheManager;
+
+module.exports = {
+  version,
+  __version__: version,
+  errors,
+  cache: cacheManager,
+  ModelCacheManager: cache.ModelCacheManager,
+  vlm,
+  load: vlm.load,
+  doctor: doctor.runDoctor,
+  cv,
+  detect
+};