karnel-termux 4.16.0 → 4.16.1

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

@@ -245,12 +245,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 +265,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 +327,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() {

package/karnel/utils/agent_actions.sh

@@ -1142,9 +1142,22 @@ 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"
+		if agent_confirm "Install Cactus now? (karnel install ai --cactus)" _agent_install_cactus; then
+			import "@/tools/ai/cactus/install"
+			if install_cactus; then
+				log_success "Cactus installed — starting the model server…"
+			else
+				log_error "Cactus installation failed — start the server manually:"
+				list_item "${D_CYAN}$AGENT_SERVER_CMD${D_NC}"
+				return 1
+			fi
+		else
+			log_info "Install it later with: ${D_CYAN}karnel install ai --cactus${D_NC}"
+			list_item "Or start the server manually: ${D_CYAN}$AGENT_SERVER_CMD${D_NC}"
+			return 1
+		fi
 	fi
 	echo
 	log_info "Starting the Cactus model server in the background…"

package/karnel/utils/agent_llm.sh

@@ -121,8 +121,14 @@ 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 ! 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.1",
   "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