karnel-termux 4.16.0 → 4.16.3

package/README.md

@@ -8,7 +8,7 @@
 
 <p align="center">
   <a href="https://github.com/israelmarques1024-dotcom/karnel-termux">
-    <img src="https://img.shields.io/badge/version-4.16.0-0078D4?style=for-the-badge" alt="Version">
+    <img src="https://img.shields.io/badge/version-4.16.1-0078D4?style=for-the-badge" alt="Version">
   </a>
   <a href="https://www.npmjs.com/package/karnel-termux">
     <img src="https://img.shields.io/npm/v/karnel-termux?style=for-the-badge&logo=npm&color=cb3837" alt="npm">
@@ -36,6 +36,8 @@
 
 Created by **Israel Marques**.
 
+Core agent contributions by **devcorex**.
+
 - **43 AI tools** — Claude, Gemini, OpenCode, Cactus, Hugging Face, Ollama, KeelCode, Goose, Factory Droid and more
 - **8 languages** — Node.js, Python, Go, Rust, C/C++, PHP, Perl, Bun
 - **5 databases** — PostgreSQL, MariaDB, SQLite, MongoDB, Redis
@@ -62,7 +64,7 @@ Created by **Israel Marques**.
 ### Via checksummed GitHub release (recommended)
 
 ```bash
-version=4.16.0
+version=4.16.1
 tmpdir=$(mktemp -d) && trap 'rm -rf "$tmpdir"' EXIT
 base="https://github.com/israelmarques1024-dotcom/karnel-termux/releases/download/v$version"
 curl -fsSL "$base/karnel-termux-install.sh" -o "$tmpdir/karnel-termux-install.sh"

package/docs/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Documentation Changelog
 
+## 4.16.1 - 2026-08-22
+
+- `karnel agent ask/run`: when the model endpoint is unreachable and Cactus is
+  not installed, the agent now says so explicitly and offers to install Cactus
+  on the spot (`karnel install ai --cactus`) instead of printing a generic
+  "start your server" hint that referenced a binary the user did not have.
+- Cactus glibc installer: fresh installs are now pinned to the tested
+  `cactus-compute` version (2.0.1) — the previous unpinned spec silently pulled
+  2.1.x with a ~1.5 GB torch/CUDA dependency chain; updates keep the
+  `>=2,<3` range used by the proot path.
+- Cactus glibc installer: pip output is now streamed live (and mirrored to the
+  install log) instead of being hidden behind an indeterminate spinner, which
+  made multi-minute downloads look frozen.
+- Credits: devcorex credited as a core agent contributor in `karnel agent`
+  help/REPL screens and project READMEs.
+
 ## 4.16.0 - 2026-08-20
 
 - Rebranded fully to Karnel: removed every remaining reference to DevCoreX and

package/docs/README.md

@@ -29,3 +29,7 @@ With a single CLI (`karnel`), you can install and manage 43 AI tools, 8 language
 - **[Supabase CLI](./cli/README.md#supabase--remote-project-helpers)** — `karnel supabase` remote-project helpers
 - **[Architecture](./ARCHITECTURE.md)** — Project structure, module system, import mechanism
 - **[Changelog](./CHANGELOG.md)** — Version history, bug fixes, known issues
+
+## Credits
+
+Created by **Israel Marques**. Core agent contributions by **devcorex**.

package/karnel/cli/commands/agent.sh

@@ -13,6 +13,9 @@
 # and DESCRIBES. bash EXECUTES. In the REPLs (and -p prompts on a
 # TTY) typing `@query` opens an fzf picker to attach a file's
 # contents to your message.
+#
+# Credits:
+#   devcorex — core agent contributor
 # ============================================================
 
 import "@/utils/log"
@@ -28,6 +31,8 @@ agent_help() {
 	echo
 	box "Karnel Agent — Local AI Assistant & Task Agent"
 	echo
+	printf "    ${D_GRAY}credits: devcorex — core agent${D_NC}\n"
+	echo
 	log_info "Usage: karnel agent <ask|run|config> [options]"
 	echo
 	separator_section "Subcommands"
@@ -552,6 +557,8 @@ agent_ask_repl() {
 	agent_banner
 	separator_section "Karnel Agent — Ask"
 	echo
+	printf "    ${D_GRAY}credits: devcorex — core agent${D_NC}\n"
+	echo
 	agent_status_line
 	echo
 	list_item "Type ${D_CYAN}/help${D_NC} to see all commands"
@@ -667,6 +674,8 @@ agent_run_repl() {
 	agent_banner
 	separator_section "Karnel Agent — Run ($([[ $AGENT_PLAN_MODE == 1 ]] && echo 'PLAN · read-only' || echo 'BUILD mode'))"
 	echo
+	printf "    ${D_GRAY}credits: devcorex — core agent${D_NC}\n"
+	echo
 	agent_status_line
 	echo
 	list_item "Type ${D_CYAN}/help${D_NC} to see all commands"

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

@@ -188,7 +188,10 @@ _cactus_write_wrapper() {
     cat >"$temporary" <<EOF
 #!$PREFIX/bin/bash
 # Karnel-managed Cactus wrapper (qemu-aarch64 emulation)
-exec proot-distro login --shared-tmp ubuntu -- env CACTUS_EMULATE=1 $CACTUS_CONTAINER_DIR/venv/bin/cactus "\$@"
+# The server loads the engine via ctypes inside the python process, so the
+# whole interpreter must run under qemu-aarch64; CACTUS_EMULATE=1 makes the
+# CLI wrap native subprocess children (bin/run) with qemu as well.
+exec proot-distro login --shared-tmp ubuntu -- env CACTUS_EMULATE=1 qemu-aarch64 -cpu max -L / $CACTUS_CONTAINER_DIR/venv/bin/python -m cactus "\$@"
 EOF
   else
     cat >"$temporary" <<EOF
@@ -245,12 +248,16 @@ _cactus_cli_install_deps_native() {
 }
 
 _cactus_cli_install_pip_glibc_impl() {
+  local pkg_spec="cactus-compute==${CACTUS_VERSION}"
   local install_args=""
   if [ "${1:-install}" = "update" ]; then
+    pkg_spec='cactus-compute>=2,<3'
     install_args="--upgrade"
   fi
 
-  if ! _cactus_cli_glibc_run -m pip install $install_args cactus-compute &>>"$CACTUS_CLI_LOG_FILE"; then
+  _cactus_cli_glibc_run -m pip install $install_args "$pkg_spec" 2>&1 | tee -a "$CACTUS_CLI_LOG_FILE"
+  local pip_rc=${PIPESTATUS[0]}
+  if (( pip_rc != 0 )); then
     log_error "Failed to install Cactus Engine CLI"
     return 1
   fi
@@ -261,8 +268,10 @@ _cactus_cli_install_pip_glibc_impl() {
 }
 
 _cactus_cli_install_pip_glibc() {
-  log_info "This downloads the Cactus Engine wheel (~24 MB) plus core deps (numpy, huggingface-hub, fastapi) into the glibc Python environment"
-  loading "Installing Cactus-compute (pip)" _cactus_cli_install_pip_glibc_impl "$@"
+  log_info "This downloads the Cactus Engine wheel (~26 MB) plus dependencies (torch, numpy, fastapi...) — it can take several minutes; progress is shown below"
+  log_info "Full log: ${D_CYAN}$CACTUS_CLI_LOG_FILE${D_NC}"
+  echo
+  _cactus_cli_install_pip_glibc_impl "$@"
 }
 
 _cactus_cli_post_install_glibc() {
@@ -321,7 +330,7 @@ _cactus_cli_verify_impl() {
 }
 
 _cactus_cli_verify_glibc() {
-  loading "Verifying Cactus Engine CLI" _cactus_cli_verify_impl
+  loading "Verifying Cactus Engine CLI (first engine load, may take a few minutes)" _cactus_cli_verify_impl
 }
 
 _cactus_cli_create_glibc_wrapper() {
@@ -330,12 +339,18 @@ _cactus_cli_create_glibc_wrapper() {
     log_error "Wrapper template not found at $wrapper_src"
     return 1
   fi
-  cp "$wrapper_src" "$PREFIX/bin/cactus"
+  sed "1s|^#!.*|#!$PREFIX/bin/bash|" "$wrapper_src" >"$PREFIX/bin/cactus"
   chmod +x "$PREFIX/bin/cactus"
   return 0
 }
 
 _cactus_cli_install_native() {
+  if ! _cactus_cpu_supported; then
+    log_error "This CPU lacks ARMv8.1 features (LSE/fp16/dotprod) required by the native Cactus engine — it would crash with Illegal instruction"
+    list_item "Re-run ${D_CYAN}karnel install ai --cactus${D_NC} and choose ${D_CYAN}proot-distro (ubuntu container)${D_NC}"
+    list_item "That method runs under qemu-aarch64 emulation: functional but very slow on this CPU"
+    return 1
+  fi
   _cactus_cli_install_deps_native || return 1
   _cactus_cli_install_pip_glibc || return 1
   _cactus_cli_verify_glibc || return 1
@@ -364,7 +379,7 @@ _cactus_cli_create_proot_wrapper() {
     log_error "Wrapper template not found at $wrapper_src"
     return 1
   fi
-  cp "$wrapper_src" "$PREFIX/bin/cactus"
+  sed "1s|^#!.*|#!$PREFIX/bin/bash|" "$wrapper_src" >"$PREFIX/bin/cactus"
   chmod +x "$PREFIX/bin/cactus"
   return 0
 }
@@ -390,7 +405,7 @@ _cactus_cli_installed_version() {
   fi
 
   if [ "$method" = "proot" ]; then
-    _spin_capture "Detecting version" bash -c 'proot-distro login --shared-tmp ubuntu -- python3 -c "from importlib.metadata import version; print(version(\"cactus-compute\"))" 2>/dev/null'
+    _spin_capture "Detecting version" bash -c 'proot-distro login --shared-tmp ubuntu -- /opt/karnel/cactus/venv/bin/python -c "from importlib.metadata import version; print(version(\"cactus-compute\"))" 2>/dev/null'
   else
     _spin_capture "Detecting version" bash -c 'printf "%s\n" "from importlib.metadata import version; print(version(\"cactus-compute\"))" | glibc-runner -s "$PREFIX/glibc/bin/python" - 2>/dev/null'
   fi
@@ -403,14 +418,11 @@ _cactus_update_native() {
   fi
 
   if [ "$method" = "proot" ]; then
-    if ! _cactus_proot /bin/bash -c 'python3 -m pip install --break-system-packages --upgrade cactus-compute' &>>"$CACTUS_CLI_LOG_FILE"; then
+    _cactus_ensure_ubuntu || return 1
+    if ! _install_cactus_inside_ubuntu || ! _cactus_apply_emulation_patch || ! _cactus_write_wrapper || ! _cactus_validate; then
       log_error "Failed to update Cactus Engine CLI"
       return 1
     fi
-    if ! timeout 300 proot-distro login --shared-tmp ubuntu -- python3 -c "import cactus" &>>"$CACTUS_CLI_LOG_FILE"; then
-      log_error "Cactus Engine CLI updated but the native engine failed to load"
-      return 1
-    fi
     log_success "Cactus Engine CLI (proot-distro) updated"
     return 0
   fi
@@ -428,7 +440,7 @@ _cactus_uninstall_native() {
   fi
 
   if [ "$method" = "proot" ]; then
-    _cactus_proot python3 -m pip uninstall -y cactus-compute &>>"$CACTUS_CLI_LOG_FILE"
+    proot-distro login ubuntu -- rm -rf /opt/karnel/cactus &>>"$CACTUS_CLI_LOG_FILE"
     rm -f "$PREFIX/bin/cactus"
     rm -rf "$CACTUS_DATA_DIR"
     log_success "Cactus Engine CLI (proot-distro) uninstalled"

package/karnel/utils/agent_actions.sh

@@ -1142,9 +1142,26 @@ agent_server_ensure() {
 		return 0
 	fi
 	if ! command -v cactus &>/dev/null; then
-		log_warn "cactus not installed — start the server manually:"
-		list_item "${D_CYAN}$AGENT_SERVER_CMD${D_NC}"
-		return 1
+		echo
+		log_warn "Cactus (the local model server) is not installed"
+		list_item "Install: ${D_CYAN}karnel install ai --cactus${D_NC}"
+		echo
+		if agent_confirm "Install Cactus now?" _agent_install_cactus; then
+			import "@/tools/ai/cactus/install"
+			install_cactus
+			local _cactus_rc=$?
+			if (( _cactus_rc == 0 || _cactus_rc == 2 )); then
+				log_success "Cactus installed — starting the model server…"
+			else
+				log_error "Cactus installation failed — try again later:"
+				list_item "${D_CYAN}karnel install ai --cactus${D_NC}"
+				list_item "Log: ${D_CYAN}$KARNEL_CACHE/install_ai.log${D_NC}"
+				return 1
+			fi
+		else
+			list_item "When it is installed, the server starts automatically"
+			return 1
+		fi
 	fi
 	echo
 	log_info "Starting the Cactus model server in the background…"
@@ -1189,7 +1206,7 @@ agent_server_stop() {
 agent_confirm() {
 	local prompt="$1" var="$2" _val
 	while true; do
-		printf '    %s%s [%s]%s\n' "$D_YELLOW" "$prompt" "${D_GREEN}y${GRAY}/${D_RED}n${NC}" "$NC" >&2
+		printf '    %b%b [%b]%b\n' "$D_YELLOW" "$prompt" "${D_GREEN}y${GRAY}/${D_RED}n${NC}" "$NC" >&2
 		printf '    > ' >&2
 		read -rn1 _val
 		echo >&2
@@ -1202,7 +1219,7 @@ agent_confirm() {
 			read -r "$var" <<<"n"
 			return 1
 			;;
-		*) printf '    %s✖%s Reply y or n\n' "$RED" "$NC" >&2 ;;
+		*) printf '    %b✖%b Reply y or n\n' "$RED" "$NC" >&2 ;;
 		esac
 	done
 }

package/karnel/utils/agent_llm.sh

@@ -121,8 +121,21 @@ agent_models_url() {
 agent_check_server() {
 	local models
 	models=$(curl -fsS -m 6 "$(agent_models_url)" 2>/dev/null) || {
-		log_warn "Cannot reach endpoint: ${D_CYAN}$AGENT_ENDPOINT${D_NC}"
-		list_item "Start your server, e.g.: ${D_CYAN}cactus serve Cactus-Compute/gemma-4-E2B-it --host 127.0.0.1 --port 8000 --no-cloud-handoff${D_NC}"
+		if agent_server_running; then
+			log_warn "The model server is starting — first run downloads the model (${D_CYAN}this can take several minutes${D_NC})"
+			list_item "Watch progress: ${D_CYAN}tail -f $AGENT_SERVER_LOG${D_NC}"
+			list_item "It will answer automatically once ${D_CYAN}$AGENT_ENDPOINT${D_NC} is up"
+		elif pgrep -f "cactus.* serve|cactus.launcher.py serve" &>/dev/null; then
+			log_warn "A Cactus server process is running but ${D_CYAN}$AGENT_ENDPOINT${D_NC} is not answering yet — it may still be downloading or loading the model"
+			list_item "Watch progress: ${D_CYAN}tail -f $AGENT_SERVER_LOG${D_NC}"
+		elif ! command -v cactus &>/dev/null; then
+			log_warn "Cannot reach endpoint: ${D_CYAN}$AGENT_ENDPOINT${D_NC} — Cactus is not installed"
+			list_item "Install it: ${D_CYAN}karnel install ai --cactus${D_NC}"
+			list_item "Or point to a running server: ${D_CYAN}karnel agent config endpoint <url>${D_NC}"
+		else
+			log_warn "Cannot reach endpoint: ${D_CYAN}$AGENT_ENDPOINT${D_NC}"
+			list_item "Start your server, e.g.: ${D_CYAN}$AGENT_SERVER_CMD${D_NC}"
+		fi
 		return 1
 	}
 	if command -v jq &>/dev/null && echo "$models" | jq -e '.data' &>/dev/null; then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karnel-termux",
-  "version": "4.16.0",
+  "version": "4.16.3",
   "description": "Modular Dev Environment for Termux — install languages, databases, AI agents, editors, and more with one command",
   "bin": {
     "karnel": "karnel/bin/karnel"
@@ -39,7 +39,8 @@
   ],
   "author": "israel marques",
   "contributors": [
-    "israel marques"
+    "israel marques",
+    "devcorex"
   ],
   "license": "MIT",
   "bugs": {

package/karnel/RELEASE_COMMIT

@@ -1 +0,0 @@
-b96d4c7cb3e38a356ca310c3e9d8de39aea605ca