amv-llamacpp 0.0.0-stage → 1.5.0

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to use, reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 uno-km (AMEVA Project)
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,83 @@
-# Temporary Holding Version
+# AMV-LlamaCpp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **마이그레이션 안내**: 이 패키지는 `termux-llamacpp`에서 `amv-llamacpp`로 이름이 바뀌었습니다. 기존 `termux-llamacpp` 배포본(PyPI/npm)은 호환을 위해 당분간 유지되나 deprecated 상태이며 더 이상 갱신되지 않습니다. `pip install amv-llamacpp` / `npm install amv-llamacpp`로 전환하십시오.
+>
+> Android **Termux 환경** 또는 **안드로이드 Linux 커널(루팅 없이 Linux 환경이 구동되는 모든 디바이스)** 에서 동작합니다 — Termux 전용이 아닙니다.
+
+[![PyPI](https://img.shields.io/pypi/v/amv-llamacpp.svg?style=flat-square&color=0369a1)](https://pypi.org/project/amv-llamacpp/)
+[![Python](https://img.shields.io/pypi/pyversions/amv-llamacpp.svg?style=flat-square)](https://pypi.org/project/amv-llamacpp/)
+[![npm](https://img.shields.io/npm/v/amv-llamacpp.svg?style=flat-square&color=b91c1c)](https://www.npmjs.com/package/amv-llamacpp)
+[![npm downloads](https://img.shields.io/npm/dm/amv-llamacpp.svg?style=flat-square&color=b91c1c)](https://www.npmjs.com/package/amv-llamacpp)
+[![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/amv-llamacpp)
+
+> **디바이스 리소스를 활용한 Android Termux ARM64 전용 GGUF LLM 런타임, 모델 매니저 및 OpenAI 호환 REST/SSE 서버**  
+> *Production-Grade GGUF LLM Runtime Utilizing Device Resources, Model Manager & OpenAI Server for Android ARM64*
+
+---
+
+## Architecture & Overview
+
+검증된 Android Bionic ARM64 네이티브 바이너리와 필수 공유 라이브러리, 디바이스 리소스 최적화 연동을 통해 제로 컴파일 로컬 실행과 안정적인 OpenAI 호환 REST/SSE 스트리밍 서버를 제공합니다.
+
+Ships verified Android ARM64 native binaries with bundled shared libraries and device resource optimization, enabling instant zero-compilation local inference and a robust OpenAI-compatible REST/SSE server.
+
+---
+
+## Installation & Quickstart
+
+### Python (PyPI)
+```bash
+pip install amv-llamacpp
+```
+```python
+from termux_llamacpp import LlamaRuntime, RuntimeConfig
+
+# 1. Initialize Runtime with Vulkan GPU Acceleration
+config = RuntimeConfig(
+    model_path="models/Llama-3.2-1B-Instruct-Q4_K_M.gguf",
+    device="auto",
+    threads=4,
+    context_size=2048
+)
+runtime = LlamaRuntime(config)
+
+# 2. Synchronous or Streaming Text Generation
+output = runtime.generate("한국의 사계절 중 가을의 매력에 대해 설명해줘.", max_tokens=256)
+print(output.text)
+print(f"Speed: {output.metrics.eval_tokens_per_sec:.2f} t/s (Prompt: {output.metrics.prompt_tokens_per_sec:.2f} t/s)")
+```
+
+### Node.js / TypeScript (npm)
+```bash
+npm install amv-llamacpp
+```
+```typescript
+import { LlamaRuntime } from "amv-llamacpp";
+
+// 1. Initialize ESM Runtime
+const runtime = new LlamaRuntime({
+  modelPath: "models/Llama-3.2-1B-Instruct-Q4_K_M.gguf",
+  device: "auto",
+  threads: 4
+});
+
+// 2. Generate Completion
+const result = await runtime.generate({
+  prompt: "Explain the architectural philosophy of edge computing.",
+  maxTokens: 256
+});
+console.log("Response:", result.text);
+console.log(`Generation Speed: ${result.metrics.evalTokensPerSec} t/s`);
+```
+
+---
+
+## Official Documentation & Benchmarks
+- [Official Architecture & API Reference](https://uno-km.vercel.app/lib/llamacpp/)
+- [Ecosystem Metrics & Registry Stats](https://uno-km.vercel.app/foundation/metrics)
+- [AMEVA Open-Source Foundation Portal](https://uno-km.vercel.app/foundation/index.html)
+
+---
+
+## License
+Licensed under the Apache-2.0 License. Copyright (c) 2026 Eunho Kim ([@uno-km](https://github.com/uno-km)).

package/README.pypi.md

@@ -0,0 +1,43 @@
+# Termux-LlamaCpp (Python)
+
+[![PyPI](https://img.shields.io/pypi/v/termux-llamacpp.svg?style=flat-square&color=0369a1)](https://pypi.org/project/termux-llamacpp/)
+[![Python](https://img.shields.io/pypi/pyversions/termux-llamacpp.svg?style=flat-square)](https://pypi.org/project/termux-llamacpp/)
+[![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/termux-llamacpp)
+
+> Production-Grade GGUF LLM Runtime Utilizing Device Resources, Model Manager & OpenAI Server for Android ARM64
+
+## Installation
+
+```bash
+pip install termux-llamacpp
+```
+
+## Quickstart
+
+```python
+from termux_llamacpp import LlamaRuntime, RuntimeConfig
+
+# 1. Initialize Runtime with Vulkan GPU Acceleration
+config = RuntimeConfig(
+    model_path="models/Llama-3.2-1B-Instruct-Q4_K_M.gguf",
+    device="auto",
+    threads=4,
+    context_size=2048
+)
+runtime = LlamaRuntime(config)
+
+# 2. Synchronous or Streaming Text Generation
+output = runtime.generate("한국의 사계절 중 가을의 매력에 대해 설명해줘.", max_tokens=256)
+print(output.text)
+print(f"Speed: {output.metrics.eval_tokens_per_sec:.2f} t/s (Prompt: {output.metrics.prompt_tokens_per_sec:.2f} t/s)")
+```
+
+## Description
+Ships verified Android ARM64 native binaries with bundled shared libraries and device resource optimization, enabling instant zero-compilation local inference and a robust OpenAI-compatible REST/SSE server.
+
+## Documentation
+- [Official Documentation & API Reference](https://uno-km.vercel.app/lib/llamacpp/)
+- [GitHub Repository](https://github.com/uno-km/termux-llamacpp)
+
+## License
+Apache-2.0 License. Copyright (c) 2026 Eunho Kim (@uno-km).

package/bin/cli.js

@@ -0,0 +1,55 @@
+#!/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_llamacpp.
+ * Automatically resolves Python 3 environment and dispatches to python -m termux_llamacpp.
+ */
+const fs = require('fs');
+const { spawn, execSync } = require('child_process');
+
+function findPython() {
+  if (process.env.PYTHON && fs.existsSync(process.env.PYTHON)) {
+    return process.env.PYTHON;
+  }
+  const termuxBin = '/data/data/com.termux/files/usr/bin/python3';
+  if (fs.existsSync(termuxBin)) {
+    return termuxBin;
+  }
+  const termuxBinAlt = '/data/data/com.termux/files/usr/bin/python';
+  if (fs.existsSync(termuxBinAlt)) {
+    return termuxBinAlt;
+  }
+  const candidates = ['python3', 'python'];
+  for (const cmd of candidates) {
+    try {
+      const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`;
+      const res = execSync(checkCmd, { stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim();
+      if (res) return cmd;
+    } catch (_) {}
+  }
+  return 'python3';
+}
+
+const pythonBin = findPython();
+const args = ['-m', 'termux_llamacpp', ...process.argv.slice(2)];
+
+const child = spawn(pythonBin, args, {
+  stdio: 'inherit',
+  env: process.env
+});
+
+child.on('error', (err) => {
+  console.error(`[${'termux_llamacpp'}] Failed to spawn python process (${pythonBin}):`, err.message);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code || 0);
+  }
+});

package/index.js

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+/**
+ * termux-llamacpp - JavaScript / TypeScript API Bridge
+ */
+const { spawn } = require('child_process');
+
+module.exports = {
+  packageName: 'termux-llamacpp',
+  moduleName: 'termux_llamacpp',
+  runCli: function(args = []) {
+    const pythonBin = process.env.PYTHON || 'python3';
+    return spawn(pythonBin, ['-m', 'termux_llamacpp', ...args], {
+      stdio: 'inherit',
+      env: process.env
+    });
+  }
+};

package/js/esm/crawler.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+export interface DiscoveredModel {
+    repoId: string;
+    name: string;
+    downloads: number;
+    likes: number;
+    recommendedFile: string;
+    downloadUrl: string;
+}
+export declare class HuggingFaceCrawler {
+    private hfToken?;
+    constructor(hfToken?: string);
+    isPlaywrightAvailable(): Promise<boolean>;
+    discover(options?: {
+        query?: string;
+        limit?: number;
+        deepCrawl?: boolean;
+    }): Promise<DiscoveredModel[]>;
+}
+//# sourceMappingURL=crawler.d.ts.map

package/js/esm/crawler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawler.d.ts","sourceRoot":"","sources":["../src/crawler.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAC,CAAS;IAEzB,YAAY,OAAO,CAAC,EAAE,MAAM,EAE3B;IAEY,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAYrD;IAEY,QAAQ,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA8CvH;CACF"}

package/js/esm/crawler.js

@@ -0,0 +1,73 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HuggingFaceCrawler = void 0;
+const exceptions_js_1 = require("./exceptions.js");
+class HuggingFaceCrawler {
+    hfToken;
+    constructor(hfToken) {
+        this.hfToken = hfToken || process.env.HF_TOKEN;
+    }
+    async isPlaywrightAvailable() {
+        try {
+            await import("termux-playwright");
+            return true;
+        }
+        catch {
+            try {
+                await import("playwright");
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+    }
+    async discover(options = {}) {
+        const query = options.query || "gguf";
+        const limit = options.limit || 10;
+        const deepCrawl = options.deepCrawl ?? false;
+        if (deepCrawl) {
+            const available = await this.isPlaywrightAvailable();
+            if (!available) {
+                throw new exceptions_js_1.DependencyMissingError("termux-playwright", "Hugging Face 동적 페이지 렌더링 및 심층 GGUF 파일 크롤링");
+            }
+            // If available, perform dynamic crawling
+        }
+        const url = new URL("https://huggingface.co/api/models");
+        url.searchParams.set("search", query);
+        url.searchParams.set("filter", "gguf");
+        url.searchParams.set("sort", "downloads");
+        url.searchParams.set("direction", "-1");
+        url.searchParams.set("limit", String(limit));
+        const headers = {
+            "User-Agent": "termux-llamacpp-js/1.0.0"
+        };
+        if (this.hfToken) {
+            headers["Authorization"] = `Bearer ${this.hfToken}`;
+        }
+        const response = await fetch(url.toString(), { headers });
+        if (!response.ok) {
+            throw new Error(`Hugging Face API error: ${response.statusText}`);
+        }
+        const rawData = (await response.json());
+        return rawData.map((item) => {
+            const repoId = item.id || "";
+            const repoName = repoId.split("/").pop() || repoId;
+            const recFile = `${repoName}-Q4_K_M.gguf`;
+            return {
+                repoId,
+                name: repoName,
+                downloads: item.downloads || 0,
+                likes: item.likes || 0,
+                recommendedFile: recFile,
+                downloadUrl: `https://huggingface.co/${repoId}/resolve/main/${recFile}`
+            };
+        });
+    }
+}
+exports.HuggingFaceCrawler = HuggingFaceCrawler;
+//# sourceMappingURL=crawler.js.map

package/js/esm/crawler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawler.js","sourceRoot":"","sources":["../src/crawler.ts"],"names":[],"mappings":"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"}

package/js/esm/exceptions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+export declare class TermuxLlamaError extends Error {
+    constructor(message: string);
+}
+export declare class ModelNotFoundError extends TermuxLlamaError {
+    readonly modelIdentifier: string;
+    readonly searchPath: string;
+    constructor(modelIdentifier: string, searchPath?: string);
+}
+export declare class DependencyMissingError extends TermuxLlamaError {
+    readonly packageName: string;
+    readonly reason: string;
+    constructor(packageName?: string, reason?: string);
+}
+//# sourceMappingURL=exceptions.d.ts.map

package/js/esm/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../src/exceptions.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,SAAgB,eAAe,EAAE,MAAM,CAAC;IACxC,SAAgB,UAAU,EAAE,MAAM,CAAC;IAEnC,YAAY,eAAe,EAAE,MAAM,EAAE,UAAU,GAAE,MAAW,EAmB3D;CACF;AAED,qBAAa,sBAAuB,SAAQ,gBAAgB;IAC1D,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,YAAY,WAAW,GAAE,MAA4B,EAAE,MAAM,GAAE,MAAW,EAezE;CACF"}

package/js/esm/exceptions.js

@@ -0,0 +1,52 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+export class TermuxLlamaError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "TermuxLlamaError";
+  }
+}
+
+export class ModelNotFoundError extends TermuxLlamaError {
+  constructor(modelIdentifier, searchPath = "") {
+    const msg =
+      `\n================================================================================\n` +
+      `[termux-llamacpp] MODEL NOT FOUND: '${modelIdentifier}'\n` +
+      `================================================================================\n` +
+      `지정된 GGUF 모델을 로컬 디렉터리에서 찾을 수 없습니다.\n` +
+      `검색 경로: ${searchPath || "~/.termux-llama/models/"}\n\n` +
+      `해결 방법:\n` +
+      `  1. 사전 큐레이션 모델 다운로드:\n` +
+      `     termux-llama download qwen2.5-1.5b-instruct\n\n` +
+      `  2. Hugging Face에서 직접 다운로드:\n` +
+      `     termux-llama download <repo_id> <filename>\n\n` +
+      `  3. 로컬 모델 목록 확인:\n` +
+      `     termux-llama list\n` +
+      `================================================================================`;
+    super(msg);
+    this.name = "ModelNotFoundError";
+    this.modelIdentifier = modelIdentifier;
+    this.searchPath = searchPath;
+  }
+}
+
+export class DependencyMissingError extends TermuxLlamaError {
+  constructor(packageName = "termux-playwright", reason = "") {
+    const msg =
+      `\n================================================================================\n` +
+      `[termux-llamacpp] DEPENDENCY MISSING: '${packageName}' is not installed!\n` +
+      `================================================================================\n` +
+      `${reason || "Hugging Face 동적 페이지 렌더링 및 심층 GGUF 파일 크롤링"}을(를) 수행하려면 '${packageName}' 패키지가 필요합니다.\n\n` +
+      `다음 명령어를 실행하여 설치를 진행하십시오:\n` +
+      `  - Python 환경:  pip install ${packageName}\n` +
+      `  - Node.js 환경: npm install ${packageName}\n\n` +
+      `참고: 기본 REST API 기반 검색 모드를 사용하려면 deepCrawl: false 로 호출하십시오.\n` +
+      `================================================================================`;
+    super(msg);
+    this.name = "DependencyMissingError";
+    this.packageName = packageName;
+    this.reason = reason;
+  }
+}

package/js/esm/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../src/exceptions.ts"],"names":[],"mappings":";;;AAAA,sBAA8B,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;;AAED,wBAAgC,SAAQ,gBAAgB;IACtC,eAAe,CAAS;IACxB,UAAU,CAAS;IAEnC,YAAY,eAAuB,EAAE,UAAU,GAAW,EAAE;QAC1D,MAAM,GAAG,GACP,sFAAsF;YACtF,uCAAuC,eAAe,KAAK;YAC3D,oFAAoF;YACpF,qCAAqC;YACrC,UAAU,UAAU,IAAI,yBAAyB,MAAM;YACvD,UAAU;YACV,yBAAyB;YACzB,sDAAsD;YACtD,gCAAgC;YAChC,qDAAqD;YACrD,qBAAqB;YACrB,0BAA0B;YAC1B,kFAAkF,CAAC;QACrF,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;;AAED,4BAAoC,SAAQ,gBAAgB;IAC1C,WAAW,CAAS;IACpB,MAAM,CAAS;IAE/B,YAAY,WAAW,GAAW,mBAAmB,EAAE,MAAM,GAAW,EAAE;QACxE,MAAM,GAAG,GACP,sFAAsF;YACtF,0CAA0C,WAAW,uBAAuB;YAC5E,oFAAoF;YACpF,GAAG,MAAM,IAAI,0CAA0C,eAAe,WAAW,mBAAmB;YACpG,4BAA4B;YAC5B,+BAA+B,WAAW,IAAI;YAC9C,+BAA+B,WAAW,MAAM;YAChD,8DAA8D;YAC9D,kFAAkF,CAAC;QACrF,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/js/esm/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+export { LlamaRuntime, RuntimeOptions } from "./runtime.js";
+export { ModelManager, ModelInfo, CURATED_MODELS } from "./models.js";
+export { ServerManager, ServerInstance, ServerOptions } from "./server.js";
+export { HuggingFaceCrawler, DiscoveredModel } from "./crawler.js";
+export { TermuxLlamaError, ModelNotFoundError, DependencyMissingError } from "./exceptions.js";
+//# sourceMappingURL=index.d.ts.map

package/js/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/js/esm/index.js

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DependencyMissingError = exports.ModelNotFoundError = exports.TermuxLlamaError = exports.HuggingFaceCrawler = exports.ServerInstance = exports.ServerManager = exports.CURATED_MODELS = exports.ModelManager = exports.LlamaRuntime = void 0;
+var runtime_js_1 = require("./runtime.js");
+Object.defineProperty(exports, "LlamaRuntime", { enumerable: true, get: function () { return runtime_js_1.LlamaRuntime; } });
+var models_js_1 = require("./models.js");
+Object.defineProperty(exports, "ModelManager", { enumerable: true, get: function () { return models_js_1.ModelManager; } });
+Object.defineProperty(exports, "CURATED_MODELS", { enumerable: true, get: function () { return models_js_1.CURATED_MODELS; } });
+var server_js_1 = require("./server.js");
+Object.defineProperty(exports, "ServerManager", { enumerable: true, get: function () { return server_js_1.ServerManager; } });
+Object.defineProperty(exports, "ServerInstance", { enumerable: true, get: function () { return server_js_1.ServerInstance; } });
+var crawler_js_1 = require("./crawler.js");
+Object.defineProperty(exports, "HuggingFaceCrawler", { enumerable: true, get: function () { return crawler_js_1.HuggingFaceCrawler; } });
+var exceptions_js_1 = require("./exceptions.js");
+Object.defineProperty(exports, "TermuxLlamaError", { enumerable: true, get: function () { return exceptions_js_1.TermuxLlamaError; } });
+Object.defineProperty(exports, "ModelNotFoundError", { enumerable: true, get: function () { return exceptions_js_1.ModelNotFoundError; } });
+Object.defineProperty(exports, "DependencyMissingError", { enumerable: true, get: function () { return exceptions_js_1.DependencyMissingError; } });
+//# sourceMappingURL=index.js.map

package/js/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2CAA4D;AAAnD,0GAAA,YAAY,OAAA;AACrB,yCAAsE;AAA7D,yGAAA,YAAY,OAAA;AAAa,2GAAA,cAAc,OAAA;AAChD,yCAA2E;AAAlE,0GAAA,aAAa,OAAA;AAAE,2GAAA,cAAc,OAAA;AACtC,2CAAmE;AAA1D,gHAAA,kBAAkB,OAAA;AAC3B,iDAA+F;AAAtF,iHAAA,gBAAgB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAAE,uHAAA,sBAAsB,OAAA"}

package/js/esm/models.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+export interface ModelInfo {
+    name: string;
+    repoId: string;
+    filename: string;
+    sizeMb: number;
+    quantType: string;
+    description: string;
+}
+export declare const CURATED_MODELS: Record<string, ModelInfo>;
+export declare class ModelManager {
+    readonly modelsDir: string;
+    constructor(modelsDir?: string);
+    resolveModelPath(modelIdentifier: string): string;
+    get(modelIdentifier: string): string;
+    download(options: {
+        repoId?: string;
+        filename?: string;
+        alias?: string;
+        sha256?: string;
+    }): Promise<string>;
+    listLocalModels(): Array<{
+        filename: string;
+        path: string;
+        sizeMb: number;
+    }>;
+}
+//# sourceMappingURL=models.d.ts.map

package/js/esm/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAyCpD,CAAC;AAEF,qBAAa,YAAY;IACvB,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,YAAY,SAAS,CAAC,EAAE,MAAM,EAM7B;IAEM,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CA2BvD;IAEM,GAAG,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAE1C;IAEY,QAAQ,CAAC,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgCvH;IAEM,eAAe,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAclF;CACF"}

package/js/esm/models.js

@@ -0,0 +1,139 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelManager = exports.CURATED_MODELS = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const exceptions_js_1 = require("./exceptions.js");
+exports.CURATED_MODELS = {
+    "qwen2.5-0.5b-instruct": {
+        name: "qwen2.5-0.5b-instruct",
+        repoId: "Qwen/Qwen2.5-0.5B-Instruct-GGUF",
+        filename: "qwen2.5-0.5b-instruct-q4_k_m.gguf",
+        sizeMb: 398.0,
+        quantType: "Q4_K_M",
+        description: "Ultra-lightweight Qwen 2.5 0.5B model for mobile devices."
+    },
+    "qwen2.5-1.5b-instruct": {
+        name: "qwen2.5-1.5b-instruct",
+        repoId: "Qwen/Qwen2.5-1.5B-Instruct-GGUF",
+        filename: "qwen2.5-1.5b-instruct-q4_k_m.gguf",
+        sizeMb: 986.0,
+        quantType: "Q4_K_M",
+        description: "Balanced Qwen 2.5 1.5B model for ARM64 edge inference."
+    },
+    "qwen2.5-3b-instruct": {
+        name: "qwen2.5-3b-instruct",
+        repoId: "Qwen/Qwen2.5-3B-Instruct-GGUF",
+        filename: "qwen2.5-3b-instruct-q4_k_m.gguf",
+        sizeMb: 1930.0,
+        quantType: "Q4_K_M",
+        description: "High-capability Qwen 2.5 3B model."
+    },
+    "llama-3.2-1b-instruct": {
+        name: "llama-3.2-1b-instruct",
+        repoId: "bartowski/Llama-3.2-1B-Instruct-GGUF",
+        filename: "Llama-3.2-1B-Instruct-Q4_K_M.gguf",
+        sizeMb: 881.0,
+        quantType: "Q4_K_M",
+        description: "Meta Llama 3.2 1B Instruct model."
+    },
+    "llama-3.2-3b-instruct": {
+        name: "llama-3.2-3b-instruct",
+        repoId: "bartowski/Llama-3.2-3B-Instruct-GGUF",
+        filename: "Llama-3.2-3B-Instruct-Q4_K_M.gguf",
+        sizeMb: 2020.0,
+        quantType: "Q4_K_M",
+        description: "Meta Llama 3.2 3B Instruct model."
+    }
+};
+class ModelManager {
+    modelsDir;
+    constructor(modelsDir) {
+        const baseDir = process.env.TERMUX_LLAMA_HOME || node_path_1.default.join(node_os_1.default.homedir(), ".termux-llama");
+        this.modelsDir = modelsDir || process.env.TERMUX_LLAMA_MODELS_DIR || node_path_1.default.join(baseDir, "models");
+        if (!node_fs_1.default.existsSync(this.modelsDir)) {
+            node_fs_1.default.mkdirSync(this.modelsDir, { recursive: true });
+        }
+    }
+    resolveModelPath(modelIdentifier) {
+        // 1. Direct path check
+        if (node_fs_1.default.existsSync(modelIdentifier) && modelIdentifier.endsWith(".gguf")) {
+            return node_path_1.default.resolve(modelIdentifier);
+        }
+        // 2. Direct filename in modelsDir
+        const candidatePath = node_path_1.default.join(this.modelsDir, modelIdentifier);
+        if (node_fs_1.default.existsSync(candidatePath)) {
+            return candidatePath;
+        }
+        const candidateWithExt = node_path_1.default.join(this.modelsDir, `${modelIdentifier}.gguf`);
+        if (node_fs_1.default.existsSync(candidateWithExt)) {
+            return candidateWithExt;
+        }
+        // 3. Alias check
+        const alias = modelIdentifier.trim().toLowerCase();
+        if (exports.CURATED_MODELS[alias]) {
+            const target = node_path_1.default.join(this.modelsDir, exports.CURATED_MODELS[alias].filename);
+            if (node_fs_1.default.existsSync(target)) {
+                return target;
+            }
+        }
+        // 4. Model missing: interrupt with exception
+        throw new exceptions_js_1.ModelNotFoundError(modelIdentifier, this.modelsDir);
+    }
+    get(modelIdentifier) {
+        return this.resolveModelPath(modelIdentifier);
+    }
+    async download(options) {
+        let repoId = options.repoId || "";
+        let filename = options.filename || "";
+        if (options.alias && exports.CURATED_MODELS[options.alias.toLowerCase()]) {
+            const item = exports.CURATED_MODELS[options.alias.toLowerCase()];
+            repoId = item.repoId;
+            filename = item.filename;
+        }
+        if (!repoId || !filename) {
+            throw new Error("Both repoId and filename (or a valid alias) are required.");
+        }
+        const destination = node_path_1.default.join(this.modelsDir, filename);
+        if (node_fs_1.default.existsSync(destination)) {
+            console.log(`[termux-llamacpp] Model '${filename}' is already downloaded at ${destination}`);
+            return destination;
+        }
+        const downloadUrl = `https://huggingface.co/${repoId}/resolve/main/${filename}`;
+        console.log(`[termux-llamacpp] Downloading ${filename} from ${downloadUrl}...`);
+        const response = await fetch(downloadUrl);
+        if (!response.ok) {
+            throw new Error(`Failed to download model from ${downloadUrl}: ${response.statusText}`);
+        }
+        const buffer = Buffer.from(await response.arrayBuffer());
+        node_fs_1.default.writeFileSync(destination, buffer);
+        console.log(`[termux-llamacpp] Model saved to ${destination}`);
+        return destination;
+    }
+    listLocalModels() {
+        if (!node_fs_1.default.existsSync(this.modelsDir))
+            return [];
+        return node_fs_1.default
+            .readdirSync(this.modelsDir)
+            .filter((file) => file.endsWith(".gguf"))
+            .map((file) => {
+            const full = node_path_1.default.join(this.modelsDir, file);
+            const stat = node_fs_1.default.statSync(full);
+            return {
+                filename: file,
+                path: full,
+                sizeMb: Number((stat.size / (1024 * 1024)).toFixed(2))
+            };
+        });
+    }
+}
+exports.ModelManager = ModelManager;
+//# sourceMappingURL=models.js.map

package/js/esm/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"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"}

package/js/esm/runtime.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+import { ModelManager } from "./models.js";
+import { ServerManager, ServerInstance, ServerOptions } from "./server.js";
+import { HuggingFaceCrawler } from "./crawler.js";
+export interface RuntimeOptions {
+    preset?: string;
+    modelsDir?: string;
+    binDir?: string;
+}
+export declare class LlamaRuntime {
+    readonly models: ModelManager;
+    readonly crawler: HuggingFaceCrawler;
+    readonly serverManager: ServerManager;
+    constructor(options?: RuntimeOptions);
+    static install(options?: RuntimeOptions): Promise<LlamaRuntime>;
+    serve(options: ServerOptions): Promise<ServerInstance>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/js/esm/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,YAAY;IACvB,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,aAAa,EAAE,aAAa,CAAC;IAE7C,YAAY,OAAO,GAAE,cAAmB,EAIvC;IAED,OAAoB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAG/E;IAEY,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAGlE;CACF"}

package/js/esm/runtime.js

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlamaRuntime = void 0;
+const node_child_process_1 = require("node:child_process");
+const models_js_1 = require("./models.js");
+const server_js_1 = require("./server.js");
+const crawler_js_1 = require("./crawler.js");
+class LlamaRuntime {
+    models;
+    crawler;
+    serverManager;
+    constructor(options = {}) {
+        this.models = new models_js_1.ModelManager(options.modelsDir);
+        this.crawler = new crawler_js_1.HuggingFaceCrawler();
+        this.serverManager = new server_js_1.ServerManager();
+    }
+    static async install(options = {}) {
+        const pyCmd = process.env.PYTHON || "python3";
+        const args = ["-m", "termux_llamacpp", "install"];
+        if (options.preset) {
+            args.push("--preset", options.preset);
+        }
+        console.log(`[termux-llamacpp] Executing runtime installation (preset: ${options.preset || "android-arm64-baseline"})...`);
+        await new Promise((resolve, reject) => {
+            const child = (0, node_child_process_1.spawn)(pyCmd, args, { stdio: "inherit", env: process.env });
+            child.on("error", (err) => reject(err));
+            child.on("exit", (code) => {
+                if (code === 0)
+                    resolve();
+                else
+                    reject(new Error(`Runtime installation failed with exit code ${code}`));
+            });
+        });
+        return new LlamaRuntime(options);
+    }
+    async serve(options) {
+        const resolvedPath = this.models.get(options.model);
+        return this.serverManager.serve(options, resolvedPath);
+    }
+}
+exports.LlamaRuntime = LlamaRuntime;
+//# sourceMappingURL=runtime.js.map

package/js/esm/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":";;;AAAA,2CAA2C;AAC3C,2CAA2E;AAC3E,6CAAkD;AAQlD;IACkB,MAAM,CAAe;IACrB,OAAO,CAAqB;IAC5B,aAAa,CAAgB;IAE7C,YAAY,OAAO,GAAmB,EAAE;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,wBAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,GAAG,IAAI,+BAAkB,EAAE,CAAC;QACxC,IAAI,CAAC,aAAa,GAAG,IAAI,yBAAa,EAAE,CAAC;IAC3C,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,GAAmB,EAAE;QACtD,OAAO,CAAC,GAAG,CAAC,kDAAkD,OAAO,CAAC,MAAM,IAAI,eAAe,KAAK,CAAC,CAAC;QACtG,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,OAAsB;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACzD,CAAC;CACF"}

package/js/esm/server.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+import http from "node:http";
+import { ChildProcess } from "node:child_process";
+export interface ServerOptions {
+    model: string;
+    host?: string;
+    port?: number;
+    ctxSize?: number;
+    threads?: number;
+}
+export declare class ServerInstance {
+    readonly endpoint: string;
+    readonly host: string;
+    readonly port: number;
+    private process?;
+    private httpServer?;
+    constructor(options: {
+        host: string;
+        port: number;
+        process?: ChildProcess;
+        httpServer?: http.Server;
+    });
+    isHealthy(): Promise<boolean>;
+    stop(): void;
+}
+export declare class ServerManager {
+    serve(options: ServerOptions, resolvedModelPath: string): Promise<ServerInstance>;
+}
+//# sourceMappingURL=server.d.ts.map

package/js/esm/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAGzD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAc;IACzB,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAc;IAEjC,YAAY,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,YAAY,CAAC;QAAC,UAAU,CAAC,EAAE,IAAI,CAAC,MAAM,CAAA;KAAE,EAMpG;IAEY,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAOzC;IAEM,IAAI,IAAI,IAAI,CAUlB;CACF;AAED,qBAAa,aAAa;IACX,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAqF7F;CACF"}

package/js/esm/server.js

@@ -0,0 +1,100 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerManager = exports.ServerInstance = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = __importDefault(require("node:path"));
+class ServerInstance {
+    endpoint;
+    host;
+    port;
+    process;
+    httpServer;
+    constructor(options) {
+        this.host = options.host;
+        this.port = options.port;
+        this.process = options.process;
+        this.httpServer = options.httpServer;
+        this.endpoint = `http://${this.host}:${this.port}`;
+    }
+    async isHealthy() {
+        try {
+            const res = await fetch(`${this.endpoint}/health`);
+            return res.status === 200 || res.status === 503;
+        }
+        catch {
+            return false;
+        }
+    }
+    stop() {
+        if (this.process) {
+            this.process.kill("SIGTERM");
+            this.process = undefined;
+        }
+        if (this.httpServer) {
+            this.httpServer.close();
+            this.httpServer = undefined;
+        }
+        console.log(`[termux-llamacpp] Server on ${this.endpoint} stopped.`);
+    }
+}
+exports.ServerInstance = ServerInstance;
+class ServerManager {
+    async serve(options, resolvedModelPath) {
+        const host = options.host || "127.0.0.1";
+        const port = options.port || 8080;
+        const modelName = node_path_1.default.basename(resolvedModelPath);
+        const pyCmd = process.env.PYTHON || "python3";
+        console.log("================================================================================");
+        console.log(`  [termux-llamacpp] Node.js Native Runtime Bridge`);
+        console.log("================================================================================");
+        console.log(`  Model Path : ${modelName}`);
+        console.log(`  Endpoint   : http://${host}:${port}`);
+        console.log("================================================================================");
+        const args = [
+            "-m",
+            "termux_llamacpp",
+            "serve",
+            resolvedModelPath,
+            "--host",
+            host,
+            "--port",
+            port.toString(),
+            "--ctx",
+            (options.ctxSize || 2048).toString(),
+        ];
+        if (options.threads) {
+            args.push("--threads", options.threads.toString());
+        }
+        const proc = (0, node_child_process_1.spawn)(pyCmd, args, {
+            stdio: ["ignore", "pipe", "pipe"],
+            env: process.env,
+        });
+        const instance = new ServerInstance({ host, port, process: proc });
+        const deadline = Date.now() + 30000;
+        let ready = false;
+        while (Date.now() < deadline) {
+            if (await instance.isHealthy()) {
+                ready = true;
+                break;
+            }
+            if (proc.exitCode !== null) {
+                throw new Error(`Runtime process exited prematurely with code ${proc.exitCode}`);
+            }
+            await new Promise((r) => setTimeout(r, 500));
+        }
+        if (!ready) {
+            instance.stop();
+            throw new Error(`Server failed to become ready on http://${host}:${port} within 30 seconds.`);
+        }
+        return instance;
+    }
+}
+exports.ServerManager = ServerManager;
+//# sourceMappingURL=server.js.map

package/js/esm/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,94 @@
 {
   "name": "amv-llamacpp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.5.0",
+  "description": "GGUF runtime, model manager & OpenAI server utilizing device resources for Android Termux & ARM64",
+  "main": "index.js",
+  "module": "js/esm/index.js",
+  "types": "js/esm/index.d.ts",
+  "files": [
+    "bin",
+    "js/esm",
+    "registry",
+    "LICENSE",
+    "README.md"
+  ],
+  "bin": {
+    "termux-llama": "bin/cli.js",
+    "termux-llamacpp": "bin/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p js/tsconfig.json",
+    "test": "node --test tests/*.test.js"
+  },
+  "keywords": [
+    "termux",
+    "llama.cpp",
+    "gguf",
+    "android",
+    "llm",
+    "arm64",
+    "openai-server",
+    "on-device-ai",
+    "edge-ai",
+    "mobile-ai",
+    "vulkan",
+    "vulkan-compute",
+    "gpu-acceleration",
+    "local-ai",
+    "snapdragon",
+    "adreno",
+    "arm-mali",
+    "exynos",
+    "zero-compilation",
+    "supply-chain-security",
+    "ed25519-verification",
+    "server-sent-events",
+    "streaming-inference",
+    "chat-completions",
+    "rest-api",
+    "function-calling",
+    "tool-calling",
+    "vision-llm",
+    "multimodal-ai",
+    "mmproj",
+    "qwen2.5",
+    "llama3",
+    "gemma2",
+    "deepseek",
+    "mistral",
+    "phi3",
+    "huggingface",
+    "model-manager",
+    "reverse-proxy",
+    "daemon-supervisor",
+    "termux-aichain",
+    "termux-tts",
+    "termux-stt",
+    "termux-diffusion",
+    "ameva-runtime",
+    "quantization-q4",
+    "bionic-libc",
+    "mmap-inference",
+    "autonomous-agents",
+    "ai-orchestrator"
+  ],
+  "author": "uno-km <dev@ameva.org>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/uno-km/termux-llamacpp.git"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "@ameva/runtime": ">=2.0.0",
+    "termux-playwright": ">=1.70.0"
+  },
+  "peerDependenciesMeta": {
+    "@ameva/runtime": {
+      "optional": true
+    },
+    "termux-playwright": {
+      "optional": true
+    }
+  }
+}

package/registry/models.json

@@ -0,0 +1,89 @@
+{
+  "registry_version": "1.0",
+  "models": {
+    "qwen2.5-0.5b-instruct": {
+      "model_id": "qwen2.5-0.5b-instruct",
+      "repo_id": "Qwen/Qwen2.5-0.5B-Instruct-GGUF",
+      "artifact_filename": "qwen2.5-0.5b-instruct-q4_k_m.gguf",
+      "repo_revision": "08f32c9b68a8b13a890a827038e21946059d57a2",
+      "size_mb": 398.0,
+      "quant_type": "Q4_K_M",
+      "architecture": "qwen2",
+      "license_id": "Apache-2.0",
+      "license_url": "https://www.apache.org/licenses/LICENSE-2.0",
+      "requires_acceptance": false,
+      "description": "Ultra-lightweight Qwen 2.5 0.5B model, ideal for low-RAM mobile devices.",
+      "min_ram_mb": 1500
+    },
+    "qwen2.5-1.5b-instruct": {
+      "model_id": "qwen2.5-1.5b-instruct",
+      "repo_id": "Qwen/Qwen2.5-1.5B-Instruct-GGUF",
+      "artifact_filename": "qwen2.5-1.5b-instruct-q4_k_m.gguf",
+      "repo_revision": "08f32c9b68a8b13a890a827038e21946059d57a2",
+      "size_mb": 986.0,
+      "quant_type": "Q4_K_M",
+      "architecture": "qwen2",
+      "license_id": "Apache-2.0",
+      "license_url": "https://www.apache.org/licenses/LICENSE-2.0",
+      "requires_acceptance": false,
+      "description": "Balanced Qwen 2.5 1.5B model with high reasoning and coding proficiency.",
+      "min_ram_mb": 2500
+    },
+    "qwen2.5-3b-instruct": {
+      "model_id": "qwen2.5-3b-instruct",
+      "repo_id": "Qwen/Qwen2.5-3B-Instruct-GGUF",
+      "artifact_filename": "qwen2.5-3b-instruct-q4_k_m.gguf",
+      "repo_revision": "08f32c9b68a8b13a890a827038e21946059d57a2",
+      "size_mb": 1930.0,
+      "quant_type": "Q4_K_M",
+      "architecture": "qwen2",
+      "license_id": "Apache-2.0",
+      "license_url": "https://www.apache.org/licenses/LICENSE-2.0",
+      "requires_acceptance": false,
+      "description": "High-capability Qwen 2.5 3B model for 8GB+ RAM mobile devices.",
+      "min_ram_mb": 4500
+    },
+    "llama-3.2-1b-instruct": {
+      "model_id": "llama-3.2-1b-instruct",
+      "repo_id": "bartowski/Llama-3.2-1B-Instruct-GGUF",
+      "artifact_filename": "Llama-3.2-1B-Instruct-Q4_K_M.gguf",
+      "repo_revision": "e932906b3e945c7429188e7a82c69d82136015b6",
+      "size_mb": 881.0,
+      "quant_type": "Q4_K_M",
+      "architecture": "llama",
+      "license_id": "Llama-3.2-Community",
+      "license_url": "https://llama.meta.com/llama3/license/",
+      "requires_acceptance": true,
+      "description": "Meta Llama 3.2 1B Instruct model, optimized for mobile edge inference.",
+      "min_ram_mb": 2000
+    },
+    "llama-3.2-3b-instruct": {
+      "model_id": "llama-3.2-3b-instruct",
+      "repo_id": "bartowski/Llama-3.2-3B-Instruct-GGUF",
+      "artifact_filename": "Llama-3.2-3B-Instruct-Q4_K_M.gguf",
+      "repo_revision": "e932906b3e945c7429188e7a82c69d82136015b6",
+      "size_mb": 2020.0,
+      "quant_type": "Q4_K_M",
+      "architecture": "llama",
+      "license_id": "Llama-3.2-Community",
+      "license_url": "https://llama.meta.com/llama3/license/",
+      "requires_acceptance": true,
+      "description": "Meta Llama 3.2 3B Instruct model, robust general purpose assistant.",
+      "min_ram_mb": 4500
+    },
+    "gemma-2-2b-it": {
+      "model_id": "gemma-2-2b-it",
+      "repo_id": "bartowski/gemma-2-2b-it-GGUF",
+      "artifact_filename": "gemma-2-2b-it-Q4_K_M.gguf",
+      "repo_revision": "c7429188e7a82c69d82136015b69c4a45ec466cf",
+      "size_mb": 1630.0,
+      "quant_type": "Q4_K_M",
+      "architecture": "gemma2",
+      "license_id": "Gemma-Terms-of-Use",
+      "license_url": "https://ai.google.dev/gemma/terms",
+      "requires_acceptance": true,
+      "description": "Google Gemma 2 2B Instruct model with high accuracy.",
+      "min_ram_mb": 3500
+    }
+  }
+}