karnel-termux 0.0.1

package/karnel/tools/ai/odysseus/install.sh

@@ -0,0 +1,198 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+import "@/utils/colors"
+
+LOG_FILE="$KARNEL_CACHE/install_ai.log"
+ODYSSEUS_DATA_DIR="$HOME/.local/share/karnel-data/odysseus"
+
+_odysseus_dependencies() {
+  loading "Installing dependencies" _odysseus_dependencies_impl
+}
+
+_odysseus_dependencies_impl() {
+  declare -A DEPS=(
+    ["git"]="git"
+    ["curl"]="curl"
+    ["proot-distro"]="proot-distro"
+  )
+
+  local pkg_name bin_name
+  for pkg_name in "${!DEPS[@]}"; do
+    bin_name="${DEPS[$pkg_name]}"
+    if ! command -v "$bin_name" &>/dev/null; then
+      if ! pkg install "$pkg_name" -y &>>"$LOG_FILE"; then
+        log_error "Failed to install $pkg_name"
+        return 1
+      fi
+    fi
+  done
+
+  return 0
+}
+
+_odysseus_detect_ubuntu_root() {
+  local root
+  root="$(find /data/data/com.termux -maxdepth 10 -type d \
+    -name "rootfs" -path "*/containers/ubuntu/*" 2>/dev/null | head -1)"
+
+  if [ -z "$root" ]; then
+    root="$(find /data/data/com.termux -maxdepth 10 -type d \
+      -name "ubuntu" -path "*/installed-rootfs/*" 2>/dev/null | head -1)"
+  fi
+
+  echo "$root"
+}
+
+_odysseus_proot_ubuntu() {
+  proot-distro login \
+    --shared-tmp \
+    ubuntu \
+    -- "$@"
+}
+
+_install_odysseus_impl() {
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  if ! command -v proot-distro &>/dev/null; then
+    pkg install proot-distro -y &>>"$LOG_FILE"
+  fi
+
+  if [ ! -d "$(_odysseus_detect_ubuntu_root)" ]; then
+    proot-distro install ubuntu:24.04 &>>"$LOG_FILE"
+  fi
+
+  _odysseus_proot_ubuntu /bin/bash -c '
+    export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
+    export DEBIAN_FRONTEND=noninteractive
+
+    apt-get update -qq && apt-get upgrade -y -qq && apt-get install -y -qq curl git python3-pip
+
+    python3 -m pip install --break-system-packages \
+      fastapi uvicorn python-multipart python-dotenv httpx pydantic pydantic-settings \
+      mcp bcrypt sqlalchemy aiosqlite jinja2 aiofiles python-dateutil \
+      pyotp qrcode croniter pypdf beautifulsoup4 charset-normalizer \
+      numpy chromadb-client fastembed youtube-transcript-api markdown \
+      nh3 icalendar caldav pytest pytest-asyncio
+  ' &>>"$LOG_FILE"
+
+  _odysseus_proot_ubuntu /bin/bash -c '
+    export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
+
+    if [ ! -d /root/odysseus ]; then
+      git clone --depth 1 https://github.com/pewdiepie-archdaemon/odysseus.git /root/odysseus
+    fi
+
+    cd /root/odysseus
+    if [ -f requirements.txt ]; then
+      python3 -m pip install --break-system-packages -r requirements.txt 2>&1
+    fi
+  ' &>>"$LOG_FILE"
+
+  local ubuntu_root
+  ubuntu_root="$(_odysseus_detect_ubuntu_root)"
+
+  if [ -z "$ubuntu_root" ]; then
+    log_error "Ubuntu rootfs not found"
+    return 1
+  fi
+
+  local wrapper_path="$PREFIX/bin/odysseus"
+  cat > "$wrapper_path" << WRAPPER
+#!$PREFIX/bin/bash
+exec proot-distro login --shared-tmp ubuntu -- bash -c 'cd /root/odysseus && exec python3 app.py "\$@"' bash "\$@"
+WRAPPER
+  chmod +x "$wrapper_path"
+
+  log_success "Odysseus installed (proot-distro)"
+  echo
+  log_info "Start with: ${D_CYAN}odysseus${NC}"
+  log_info "Web UI at: ${D_CYAN}http://localhost:7000${NC}"
+}
+
+_install_odysseus_native() {
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  if ! command -v glibc-repo &>/dev/null && ! command -v glibc &>/dev/null; then
+    pkg install glibc-repo glibc clang curl git tar -y &>>"$LOG_FILE" || true
+  fi
+
+  _odysseus_proot_ubuntu /bin/bash -c '
+    export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
+    export DEBIAN_FRONTEND=noninteractive
+
+    if [ ! -d /root/odysseus ]; then
+      git clone --depth 1 https://github.com/pewdiepie-archdaemon/odysseus.git /root/odysseus
+    fi
+
+    cd /root/odysseus
+    if [ -f requirements.txt ]; then
+      python3 -m pip install --break-system-packages -r requirements.txt 2>&1
+    fi
+  ' &>>"$LOG_FILE"
+
+  mkdir -p "$ODYSSEUS_DATA_DIR"
+  local wrapper_path="$PREFIX/bin/odysseus"
+  cat > "$wrapper_path" << WRAPPER
+#!$PREFIX/bin/bash
+exec proot-distro login --shared-tmp ubuntu -- bash -c 'cd /root/odysseus && exec python3 app.py "\$@"' bash "\$@"
+WRAPPER
+  chmod +x "$wrapper_path"
+
+  log_success "Odysseus installed (native glibc)"
+  echo
+  log_info "Start with: ${D_CYAN}odysseus${NC}"
+  log_info "Web UI at: ${D_CYAN}http://localhost:7000${NC}"
+}
+
+install_odysseus() {
+  if command -v odysseus &>/dev/null || [ -d "$ODYSSEUS_DATA_DIR/repo" ]; then
+    log_info "Odysseus is already installed"
+    return 2
+  fi
+
+  log_info "Installing Odysseus..."
+
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  _odysseus_dependencies || return 1
+
+  log_info "Installing via proot-distro Ubuntu (Docker not available on Termux)..."
+  _install_odysseus_impl
+
+  log_success "Odysseus installed successfully"
+  return 0
+}
+
+uninstall_odysseus() {
+  log_info "Uninstalling Odysseus..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  if [ -f "$PREFIX/bin/odysseus" ]; then
+    rm -f "$PREFIX/bin/odysseus"
+  fi
+
+  if [ -d "$ODYSSEUS_DATA_DIR" ]; then
+    rm -rf "$ODYSSEUS_DATA_DIR"
+  fi
+
+  log_success "Odysseus uninstalled"
+  return 0
+}
+
+update_odysseus() {
+  log_info "Updating Odysseus..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  _odysseus_proot_ubuntu /bin/bash -c '
+    cd /root/odysseus && git pull
+  ' &>>"$LOG_FILE" && log_success "Odysseus updated" || {
+    log_error "Failed to update Odysseus"
+    return 1
+  }
+}
+
+reinstall_odysseus() {
+  uninstall_odysseus
+  install_odysseus
+}

package/karnel/tools/ai/ollama/README.md

@@ -0,0 +1,44 @@
+# Ollama
+
+Run open-source LLMs locally on Termux
+
+**Package:** ollama  
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Official:** https://ollama.com  
+**Type:** Local LLM runtime (pkg)  
+**License:** MIT
+
+## Description
+
+Ollama allows you to run open-source LLMs locally on Termux. It supports a wide range of models including Llama, Mistral, Gemma, Qwen, DeepSeek, and many more. All processing is done locally with no data sent to external servers.
+
+## Dependencies
+
+- Installed via pkg (termux package)
+
+## Install
+
+```bash
+karnel install ai --ollama
+```
+
+## Uninstall
+
+```bash
+karnel uninstall ai --ollama
+```
+
+## Update
+
+```bash
+karnel update ai --ollama
+```
+
+## Notes
+
+- Runs entirely locally on your device
+- Supports models from Ollama library
+- Command: `ollama`
+- Model storage: `~/.ollama/`
+

package/karnel/tools/ai/ollama/install.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+LOG_FILE="$KARNEL_CACHE/install_ai.log"
+
+_install_ollama_pkg() {
+  loading "Installing Ollama" _install_ollama_pkg_impl
+}
+
+_install_ollama_pkg_impl() {
+  if ! pkg install ollama -y &>>"$LOG_FILE"; then
+    log_error "Failed to install Ollama"
+    return 1
+  fi
+
+  return 0
+}
+
+install_ollama() {
+  if command -v ollama &>/dev/null; then
+    log_info "Ollama is already installed"
+    return 2
+  fi
+  log_info "Installing Ollama..."
+
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  _install_ollama_pkg || return 1
+
+  log_success "Ollama installed"
+  return 0
+}
+
+uninstall_ollama() {
+  if ! command -v ollama &>/dev/null; then
+    log_info "Ollama is not installed"
+    return 2
+  fi
+  log_info "Uninstalling Ollama..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  loading "Removing Ollama" _uninstall_ollama_impl
+
+  log_success "Ollama uninstalled"
+  return 0
+}
+
+_uninstall_ollama_impl() {
+  if ! pkg uninstall ollama -y &>>"$LOG_FILE"; then
+    log_error "Failed to uninstall Ollama"
+    return 1
+  fi
+  return 0
+}
+
+update_ollama() {
+  log_info "Updating Ollama..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  loading "Updating Ollama" _update_ollama_impl
+
+  log_success "Ollama updated"
+  return 0
+}
+
+_update_ollama_impl() {
+  if ! pkg upgrade ollama -y &>>"$LOG_FILE"; then
+    log_error "Failed to update Ollama"
+    return 1
+  fi
+  return 0
+}
+
+reinstall_ollama() {
+  uninstall_ollama
+  install_ollama
+}

package/karnel/tools/ai/omni-route/README.md

@@ -0,0 +1,111 @@
+# karnelRoute
+
+**AI Gateway CLI** — 236+ AI providers via a single endpoint.
+
+**Package:** karnel-route  
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Official:** https://karnelroute.online  
+**npm:** https://www.npmjs.com/package/karnelroute  
+**Type:** AI Gateway (npm package with smart wrapper)  
+**License:** MIT
+
+## Description
+
+karnelRoute is the Karnel Termux wrapper for the official `karnelroute` npm package — an AI Gateway that provides 236+ AI providers via a single endpoint, with auto-fallback to free providers and smart routing with compression (15-95% token savings).
+
+## Installation
+
+```bash
+karnel install ai --karnel-route
+```
+
+## Usage
+
+```bash
+karnel-route                         # Start AI gateway on localhost:20128
+karnel-route serve --daemon           # Start as background daemon
+karnel-route serve --daemon --no-open # Daemon without browser
+karnel-route stop                     # Stop the server
+karnel-route --help                   # Show all commands
+karnel-route --version                # Show version
+```
+
+## Dashboard
+
+Access the web dashboard at:
+- **URL:** http://localhost:20128
+- **Setup:** Configure providers at `/dashboard`
+- **API Base:** `http://localhost:20128/v1`
+
+## Architecture
+
+The wrapper uses a **3-tier fallback** strategy:
+
+1. **Local install** (`~/.karnel/packages/karnelroute/`) — Fast, no download on subsequent runs
+2. **npm install** (first run) — Downloads and caches locally with `--ignore-scripts`
+3. **npx** (last resort) — Falls back to on-demand execution
+
+### Termux / Android Native Fixes (root cause of "Internal Server Error" 500)
+
+KarnelRoute bundles `better-sqlite3` (and `sqlite-vec`) as **prebuilt `linux-x64` glibc**
+native addons. On Termux/Android the runtime is **aarch64 + Bionic libc** and
+`process.platform` reports `android`, so those addons fail to load
+(`dlopen: cannot locate symbol …`). With no working database, every HTTP request
+returns `500` and the logs show an `out of memory` DB-probe death spiral.
+
+The installer fixes this **definitively** (no workarounds) by rebuilding the
+native addons from source for the running Node/ABI:
+
+1. **Rebuild native modules** — `better-sqlite3` and `sqlite-vec` are recompiled
+   with Termux's `clang` against the local Node headers. `node-gyp` mis-detects
+   Termux as Android and demands `android_ndk_path`; the installer supplies a
+   dummy value so the Android gyp config resolves while Termux's clang compiles.
+2. **Instrumentation resilience** — Next.js `registerInstrumentation()` used to
+   *re-throw* any error from KarnelRoute's (non-critical) instrumentation hook and
+   crash the whole server. The installer patches Next's
+   `instrumentation-globals.external.js` so a hook error is logged and the server
+   keeps running (the real application database is unaffected).
+
+Both fixes are re-applied automatically on every `install` / `update`, so a fresh
+or updated install keeps working on Termux/Android.
+
+### Resetting a corrupted database
+
+If `~/.karnelroute/storage.sqlite` becomes corrupt, KarnelRoute cannot auto-recover
+and renames it to `storage.sqlite.probe-failed-*`. Remove those files and let the
+server recreate a fresh database:
+
+```bash
+rm -f ~/.karnelroute/storage.sqlite{,-wal,-shm} ~/.karnelroute/storage.sqlite.probe-failed-*
+karnel-route serve --daemon
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `karnel-route` | Shortcut to karnelroute |
+| `karnel-route serve` | Start the server |
+| `karnel-route serve --daemon` | Run in background |
+| `karnel-route stop` | Stop the daemon |
+
+## Notes
+
+- Installed via npm package: `karnelroute` (official)
+- Data directory: `~/.karnelroute/` (auto-generated config)
+- Default port: 20128
+- Dashboard requires `INITIAL_PASSWORD` (auto-generated on first run)
+- For external access, configure `JWT_SECRET` and `API_KEY_SECRET` in `.env`
+
+## Links
+
+- Website: https://karnelroute.online
+- GitHub: https://github.com/diegosouzapw/KarnelRoute
+- npm: https://www.npmjs.com/package/karnelroute
+
+## Related
+
+- `karnel ia routes` — List installed AI CLI tools
+- `karnel ia sessions` — View active AI sessions
+- `karnel install ai --karnel-route` — Install

package/karnel/tools/ai/omni-route/install.sh

@@ -0,0 +1,165 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+LOG_FILE="$KARNEL_CACHE/install_ai.log"
+
+# Check if omni-route binary exists and works
+_omni_route_ok() {
+  command -v omni-route &>/dev/null && omni-route --version &>/dev/null 2>&1
+}
+
+# Detect Termux / Android (Node reports platform "android" and uname mentions android)
+_omni_route_is_android() {
+  if [ "$(node -e 'process.stdout.write(process.platform)' 2>/dev/null)" = "android" ]; then
+    return 0
+  fi
+  case "$(uname -s 2>/dev/null) $(uname -o 2>/dev/null)" in
+    *android*|*Android*) return 0 ;;
+  esac
+  return 1
+}
+
+# Apply platform-specific fixes so omniRoute actually runs on Termux/Android.
+# Two real, root-cause issues are addressed here (no workarounds/masking):
+#   1. omniRoute bundles better-sqlite3 / sqlite-vec as prebuilt linux-x64 glibc
+#      native addons. On Android/Bionic (aarch64) those fail to load
+#      (dlopen: cannot locate symbol), so the database can never open and every
+#      HTTP request returns 500. We rebuild the native addons from source for the
+#      running Node/ABI. node-gyp mis-detects Termux as Android and demands
+#      android_ndk_path, which does not exist; we supply a dummy value so the
+#      Android gyp config resolves while Termux's own clang does the compile.
+#   2. Next.js registerInstrumentation() re-throws any error from omniRoute's
+#      (non-critical) instrumentation hook and that crash takes down the whole
+#      server. We make it log-and-continue so a transient hook error does not
+#      kill the gateway (the real application DB is unaffected).
+_omni_route_apply_platform_fixes() {
+  local pkg_root="$1"
+  [ -d "$pkg_root" ] || return 0
+  _omni_route_is_android || return 0
+
+  log_info "Termux/Android detected — applying native build fixes for omniRoute..."
+
+  local ng="/data/data/com.termux/files/usr/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js"
+  if [ -x "$ng" ] && command -v clang >/dev/null 2>&1; then
+    for mod in better-sqlite3 sqlite-vec; do
+      local moddir="$pkg_root/node_modules/$mod"
+      [ -d "$moddir" ] || continue
+      log_info "Rebuilding native module: $mod (aarch64/Bionic)"
+      if ( cd "$moddir" && CC=clang CXX=clang++ GYP_DEFINES="android_ndk_path=$PREFIX" node "$ng" rebuild --release "-Dandroid_ndk_path=$PREFIX" ) >>"$LOG_FILE" 2>&1; then
+        log_success "Rebuilt $mod"
+      else
+        log_warn "Could not rebuild $mod (see $LOG_FILE); omniRoute may fail to open its database"
+      fi
+    done
+  else
+    log_warn "Native toolchain (node-gyp/clang) not found; cannot rebuild omniRoute native modules"
+  fi
+
+  # Patch Next.js instrumentation so a non-critical hook error does not crash the server.
+  local ig
+  ig=$(find "$pkg_root/node_modules/karnelroute/dist/node_modules/next" -path '*router-utils/instrumentation-globals.external.js' 2>/dev/null | head -1)
+  if [ -n "$ig" ] && grep -q "An error occurred while loading instrumentation hook" "$ig"; then
+    if perl -0pi -e 's/err\.message = `An error occurred while loading instrumentation hook: \$\{err\.message\}`;\s*\n\s*throw err;/err.message = `An error occurred while loading instrumentation hook: ${err.message}`;\n            console.error("[instrumentation] Non-fatal error in instrumentation hook (server continues):", err && err.message ? err.message : err);/g' "$ig"; then
+      log_success "Patched Next.js instrumentation (hook errors are now non-fatal)"
+    else
+      log_warn "Could not patch Next.js instrumentation at $ig"
+    fi
+  fi
+}
+
+install_omni_route() {
+  # Already working? Still ensure platform fixes are present (e.g. after an
+  # update re-fetched a broken prebuild) and return.
+  if _omni_route_ok; then
+    log_info "omniRoute already installed ($(omni-route --version 2>&1 | tail -1))"
+    _omni_route_apply_platform_fixes "$HOME/.karnel/packages/karnelroute"
+    return 2
+  fi
+
+  # Try local install first (fast, no download)
+  local local_bin="$HOME/.karnel/packages/karnelroute/node_modules/karnelroute/bin/karnelroute.mjs"
+  if [ -f "$local_bin" ]; then
+    sed -i '1s|^#!/usr/bin/env node|#!/data/data/com.termux/files/usr/bin/node|' "$local_bin" 2>/dev/null
+    # Create both karnelroute (official) and omni-route (karnel wrapper)
+    for cmd in karnelroute omni-route; do
+      cat > "$PREFIX/bin/$cmd" <<'WRAPPER'
+#!/data/data/com.termux/files/usr/bin/env bash
+exec node "$HOME/.karnel/packages/karnelroute/node_modules/karnelroute/bin/karnelroute.mjs" "$@"
+WRAPPER
+      chmod +x "$PREFIX/bin/$cmd"
+    done
+    _omni_route_apply_platform_fixes "$HOME/.karnel/packages/karnelroute"
+    if _omni_route_ok; then
+      log_success "omniRoute restored from local install"
+      return 0
+    fi
+  fi
+
+  # Install into the local prefix (self-contained; works offline after first download)
+  log_info "Installing omniRoute (this may take a while)..."
+  mkdir -p "$HOME/.karnel/packages/karnelroute"
+  if command -v npm >/dev/null 2>&1 && npm i karnelroute --prefix "$HOME/.karnel/packages/karnelroute" 2>>"$LOG_FILE"; then
+    sed -i '1s|^#!/usr/bin/env node|#!/data/data/com.termux/files/usr/bin/node|' "$local_bin" 2>/dev/null
+    for cmd in karnelroute omni-route; do
+      cat > "$PREFIX/bin/$cmd" <<'WRAPPER'
+#!/data/data/com.termux/files/usr/bin/env bash
+exec node "$HOME/.karnel/packages/karnelroute/node_modules/karnelroute/bin/karnelroute.mjs" "$@"
+WRAPPER
+      chmod +x "$PREFIX/bin/$cmd"
+    done
+    _omni_route_apply_platform_fixes "$HOME/.karnel/packages/karnelroute"
+    if _omni_route_ok; then
+      log_success "omniRoute installed"
+      return 0
+    fi
+  fi
+
+  # Try npx as last resort
+  log_warn "npm failed, trying npx..."
+  if npx -y karnelroute --version &>/dev/null 2>&1; then
+    log_success "omniRoute available via npx"
+    return 0
+  fi
+
+  log_error "Failed to install omniRoute"
+  return 1
+}
+
+uninstall_omni_route() {
+  if ! _omni_route_ok; then
+    log_info "omniRoute is not installed"
+    return 0
+  fi
+
+  log_info "Uninstalling omniRoute..."
+  npm uninstall -g karnelroute 2>>"$LOG_FILE" 2>/dev/null
+  rm -rf "$HOME/.karnel/packages/karnelroute"
+  rm -f "$PREFIX/bin/karnelroute" "$PREFIX/bin/omni-route"
+  log_success "omniRoute uninstalled"
+  return 0
+}
+
+update_omni_route() {
+  if ! _omni_route_ok; then
+    install_omni_route
+    return $?
+  fi
+
+  # Update the canonical local install (the one the wrappers actually use),
+  # then re-apply the Termux/Android native fixes so it keeps working.
+  log_info "Updating omniRoute..."
+  if npm i karnelroute@latest --prefix "$HOME/.karnel/packages/karnelroute" 2>>"$LOG_FILE"; then
+    _omni_route_apply_platform_fixes "$HOME/.karnel/packages/karnelroute"
+    log_success "omniRoute updated"
+    return 0
+  else
+    log_error "Failed to update omniRoute"
+    return 1
+  fi
+}
+
+reinstall_omni_route() {
+  uninstall_omni_route
+  install_omni_route
+}

package/karnel/tools/ai/openclaude/README.md

@@ -0,0 +1,46 @@
+# OpenClaude
+
+Open source Claude Code alternative
+
+**Package:** @gitlawb/openclaude  
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Official:** https://github.com/gitlawb/openclaude  
+**Type:** AI client (npm global package)  
+**License:** MIT
+
+## Description
+
+OpenClaude is an open source Claude Code alternative. It provides a CLI interface for code generation, analysis, and AI assistance.
+
+## Dependencies
+
+- Node.js LTS (nodejs-lts)
+- npm
+- git, ripgrep
+
+## Install
+
+```bash
+karnel install ai --openclaude
+```
+
+## Uninstall
+
+```bash
+karnel uninstall ai --openclaude
+```
+
+## Update
+
+```bash
+karnel update ai --openclaude
+```
+
+## Notes
+
+- Installed as a global npm package: `@gitlawb/openclaude`
+- Command: `openclaude`
+- Requires an Anthropic API key
+- Environment variable: `ANTHROPIC_API_KEY`
+