karnel-termux 0.0.1

package/karnel/tools/ai/hermes-agent/README.md

@@ -0,0 +1,50 @@
+# Hermes Agent
+The self-improving AI agent built by Nous Research
+
+**Package:** hermes-agent
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Official:** https://github.com/nousresearch/hermes-agent  
+**Type:** The agent that grows with you
+**License:** MIT
+
+# Description
+
+The self-improving AI agent built by Nous Research. It's the only agent with a built-in learning loop — it creates skills from experience, improves them during use, nudges itself to persist knowledge, searches its own past conversations, and builds a deepening model of who you are across sessions.
+
+# Dependencies
+
+- python
+- clang
+- rust
+- make
+- pkg-config
+- libffi
+- openssl
+- nodejs-lts
+- ripgrep
+- ffmpeg
+
+# Install
+
+```bash
+karnel install ai --hermes-agent
+```
+
+# Uninstall
+
+```bash
+karnel uninstall ai --hermes-agent
+```
+
+# Update
+
+```bash
+karnel update ai --hermes-agent
+```
+
+# Notes
+
+- Installed using the official installer via: `curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash`
+- Command: `hermes`
+- Requires configuration for optimal performance

package/karnel/tools/ai/hermes-agent/install.sh

@@ -0,0 +1,120 @@
+#!/usr/bin/env bash
+
+import "@/utils/log"
+
+LOG_FILE="$KARNEL_CACHE/install_ai.log"
+HERMES_HOME="$HOME/.hermes"
+HERMES_DIR="$HERMES_HOME/hermes-agent"
+
+_patch_psutil_for_termux() {
+  python3 -c "import psutil; print(psutil.__version__)" 2>/dev/null && return 0
+  local tmp="$PREFIX/tmp/psutil_patch"
+  mkdir -p "$tmp"
+  pip download psutil==7.2.2 --no-binary :all: --no-deps -d "$tmp" 2>/dev/null
+  tar xzf "$tmp/psutil-7.2.2.tar.gz" -C "$tmp"
+  sed -i 's/LINUX = sys.platform.startswith("linux")/LINUX = sys.platform.startswith(("linux", "android"))/' "$tmp/psutil-7.2.2/psutil/_common.py"
+  pip install "$tmp/psutil-7.2.2"
+  rm -rf "$tmp"
+}
+
+_prebuild_c_exts() {
+  for pkg in ruamel.yaml.clib uvloop tornado; do
+    pip install "$pkg" 2>/dev/null
+  done
+}
+
+_install_hermes_agent_impl() {
+  mkdir -p "$HERMES_HOME"
+
+  # 1. Clone/pull repo
+  if [ -d "$HERMES_DIR/.git" ]; then
+    cd "$HERMES_DIR" && git pull
+  else
+    git clone https://github.com/NousResearch/hermes-agent.git "$HERMES_DIR"
+  fi
+
+  cd "$HERMES_DIR"
+
+  # 2. Patch Python version constraint (3.14 compat)
+  sed -i 's/requires-python = ">=3\.11,<3\.14"/requires-python = ">=3.11,<3.15"/' pyproject.toml
+
+  # 3. Pre-build C extensions that OOM when built together
+  _patch_psutil_for_termux
+  _prebuild_c_exts
+
+  # 4. Install (no constraints file — it hangs on Termux network)
+  pip install --no-build-isolation .
+
+  # 5. Create wrapper (pip skipped it due to --no-build-isolation)
+  cat > "$PREFIX/bin/hermes" <<-WRAPPER
+	#!/data/data/com.termux/files/usr/bin/python3
+	from hermes_cli.main import main
+	main()
+	WRAPPER
+  chmod +x "$PREFIX/bin/hermes"
+}
+
+install_hermes_agent() {
+  if command -v hermes &>/dev/null; then
+    log_info "Hermes Agent is already installed"
+    return 2
+  fi
+
+  log_info "Installing Hermes Agent (gambiarra Termux)..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  loading "Installing Hermes Agent" _install_hermes_agent_impl
+
+  if command -v hermes &>/dev/null; then
+    log_success "Hermes Agent installed successfully"
+    return 0
+  else
+    log_error "Failed to install Hermes Agent"
+    return 1
+  fi
+}
+
+uninstall_hermes_agent() {
+  if ! command -v hermes &>/dev/null; then
+    log_info "Hermes Agent is not installed"
+    return 2
+  fi
+  log_info "Uninstalling Hermes Agent..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  loading "Removing Hermes Agent" _uninstall_hermes_agent_impl
+
+  log_success "Hermes Agent uninstalled successfully"
+  return 0
+}
+
+_uninstall_hermes_agent_impl() {
+  if rm -rf "$HERMES_HOME" && rm -f "$PREFIX/bin/hermes" &>>"$LOG_FILE"; then
+    return 0
+  else
+    log_error "Failed to uninstall Hermes Agent"
+    return 1
+  fi
+}
+
+update_hermes_agent() {
+  log_info "Updating Hermes Agent..."
+  mkdir -p "$(dirname "$LOG_FILE")"
+  loading "Updating Hermes Agent" _update_hermes_agent_impl
+  log_success "Hermes Agent updated successfully"
+  return 0
+}
+
+_update_hermes_agent_impl() {
+  if ! hermes update 2>/dev/null; then
+    # Fallback: re-pull and re-install
+    cd "$HERMES_DIR" && git pull
+    pip install --no-build-isolation .
+  fi
+  return 0
+}
+
+reinstall_hermes_agent() {
+  uninstall_hermes_agent
+  install_hermes_agent
+}

package/karnel/tools/ai/kilocode-cli/README.md

@@ -0,0 +1,45 @@
+# Kilo Code CLI
+
+The open source coding agent for building with AI in VS Code, JetBrains, or the CLI
+
+**Package:** kilocode-cli  
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Official:** https://github.com/Kilo-Org/kilocode  
+**Type:** AI coding agent (Binary + glibc bootstrapper)  
+**License:** MIT
+
+## Description
+
+Kilo Code is an AI coding agent that meets you everywhere you work: VS Code, JetBrains, and the CLI. It's open source with open pricing. You pick from 500+ models, switch between them mid-task, and pay the model provider's rate with zero markup. No API keys required to start.
+
+## Dependencies
+
+- glibc-repo, glibc, clang, git, ripgrep, python, jq, nodejs-lts, curl, tar
+
+## Install
+
+```bash
+karnel install ai --kilocode-cli
+```
+
+Installs natively with a glibc bootstrapper.
+
+## Uninstall
+
+```bash
+karnel uninstall ai --kilocode-cli
+```
+
+## Update
+
+```bash
+karnel update ai --kilocode-cli
+```
+
+## Notes
+
+- Requires `glibc-repo`, `glibc`, `clang`, and other dependencies (installed automatically)
+- The native binary is stored in `~/.local/share/karnel-data/kilocode/`
+- A small C bootstrapper (`kilocode_helper.c`) handles ELF loading via the glibc dynamic linker
+- Data directory: `~/.local/share/karnel-data/kilocode/`

package/karnel/tools/ai/kilocode-cli/bin/kilocode

@@ -0,0 +1,21 @@
+#!/data/data/com.termux/files/usr/bin/bash
+
+KILOCODE_DATA_DIR="$HOME/.local/share/karnel-data/kilocode"
+
+unset LD_PRELOAD
+unset LD_LIBRARY_PATH
+
+export GODEBUG="netdns=cgo"
+export SSL_CERT_FILE="/data/data/com.termux/files/usr/etc/tls/cert.pem"
+
+LOADER="/data/data/com.termux/files/usr/glibc/lib/ld-linux-aarch64.so.1"
+REAL_BIN="$KILOCODE_DATA_DIR/kilo"
+LIB_PATH="/data/data/com.termux/files/usr/glibc/lib"
+
+if [ ! -f "$REAL_BIN" ]; then
+  echo "Error: Kilo Code CLI binary not found at $REAL_BIN" >&2
+  echo "Please run: karnel install ai --kilocode-cli" >&2
+  exit 1
+fi
+
+exec "$LOADER" --library-path "$LIB_PATH" "$REAL_BIN" "$@"

package/karnel/tools/ai/kilocode-cli/helper/kilocode_helper.c

@@ -0,0 +1,47 @@
+#include <stdlib.h>
+#include <unistd.h>
+#include <string.h>
+#include <libgen.h>
+#include <limits.h>
+#include <stdio.h>
+
+int main(int argc, char** argv) {
+    unsetenv("LD_PRELOAD");
+    unsetenv("LD_LIBRARY_PATH");
+
+    setenv("GODEBUG", "netdns=cgo", 1);
+    setenv("SSL_CERT_FILE", "/data/data/com.termux/files/usr/etc/tls/cert.pem", 1);
+
+    char exec_path[PATH_MAX];
+    ssize_t len = readlink("/proc/self/exe", exec_path, sizeof(exec_path) - 1);
+    if (len == -1) {
+        return 1;
+    }
+    exec_path[len] = '\0';
+    char* dir = dirname(exec_path);
+
+    char* loader = "/data/data/com.termux/files/usr/glibc/lib/ld-linux-aarch64.so.1";
+    char real_bin[] = "/data/data/com.termux/files/home/.local/share/karnel-data/kilocode/kilo";
+    char lib_path[] = "/data/data/com.termux/files/usr/glibc/lib";
+
+    char** new_argv = malloc((argc + 4) * sizeof(char*));
+    if (!new_argv) {
+        return 1;
+    }
+
+    new_argv[0] = loader;
+    new_argv[1] = "--library-path";
+    new_argv[2] = lib_path;
+    new_argv[3] = real_bin;
+
+    for (int i = 1; i < argc; i++) {
+        new_argv[i + 3] = argv[i];
+    }
+    new_argv[argc + 3] = NULL;
+
+    execv(loader, new_argv);
+
+    perror("execv");
+    free(new_argv);
+    return 1;
+}

package/karnel/tools/ai/kilocode-cli/install.sh

@@ -0,0 +1,179 @@
+#!/data/data/com.termux/files/usr/bin/bash
+
+import "@/utils/log"
+import "@/utils/colors"
+
+LOG_FILE="$KARNEL_CACHE/install_ai.log"
+KILOCODE_DATA_DIR="$HOME/.local/share/karnel-data/kilocode"
+
+_get_latest_kilocode_version() {
+  curl -fsSL https://api.github.com/repos/Kilo-Org/kilocode/releases/latest |
+    grep '"tag_name":' | sed -E 's/.*"([^"]+)".*/\1/'
+}
+
+_install_kilocode_deps() {
+  loading "Installing glibc and dependencies" _install_kilocode_deps_impl
+}
+
+_install_kilocode_deps_impl() {
+  if [[ ! -f $PREFIX/etc/apt/sources.list.d/glibc.list ]]; then
+    if ! yes | pkg install glibc-repo &>>"$LOG_FILE"; then
+      log_error "Failed to install glibc-repo"
+      return 1
+    fi
+  fi
+
+  if [[ ! -f $PREFIX/glibc/lib/libc.so.6 ]]; then
+    if ! yes | pkg install glibc &>>"$LOG_FILE"; then
+      log_error "Failed to install glibc"
+      return 1
+    fi
+  fi
+
+  declare -A DEPS=(
+    ["git"]="git"
+    ["ripgrep"]="rg"
+    ["python"]="python"
+    ["clang"]="clang"
+    ["jq"]="jq"
+    ["nodejs-lts"]="node"
+    ["curl"]="curl"
+    ["tar"]="tar"
+  )
+
+  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 ! yes | pkg install "$pkg_name" &>>"$LOG_FILE"; then
+        log_error "Failed to install $pkg_name"
+        return 1
+      fi
+    fi
+  done
+
+  return 0
+}
+
+_download_kilocode_binary() {
+  loading "Downloading Kilo Code CLI" _download_kilocode_binary_impl
+}
+
+_download_kilocode_binary_impl() {
+  local latest_version
+  latest_version=$(_get_latest_kilocode_version)
+  if [ -z "$latest_version" ]; then
+    log_error "Failed to fetch latest Kilo Code CLI version"
+    return 1
+  fi
+
+  mkdir -p "$KILOCODE_DATA_DIR"
+
+  local tarball="kilo-linux-arm64.tar.gz"
+  local download_url="https://github.com/Kilo-Org/kilocode/releases/download/$latest_version/$tarball"
+
+  if ! curl -fsSL "$download_url" -o "$KILOCODE_DATA_DIR/$tarball" &>>"$LOG_FILE"; then
+    log_error "Failed to download Kilo Code CLI binary"
+    return 1
+  fi
+
+  if ! tar -zxf "$KILOCODE_DATA_DIR/$tarball" -C "$KILOCODE_DATA_DIR" &>>"$LOG_FILE"; then
+    log_error "Failed to extract Kilo Code CLI binary"
+    return 1
+  fi
+
+  rm -f "$KILOCODE_DATA_DIR/$tarball"
+
+  if [ ! -f "$KILOCODE_DATA_DIR/kilo" ]; then
+    log_error "Kilo Code CLI binary not found after extraction"
+    return 1
+  fi
+
+  chmod +x "$KILOCODE_DATA_DIR/kilo"
+  return 0
+}
+
+_compile_kilocode_helper() {
+  loading "Compiling helper" _compile_kilocode_helper_impl
+}
+
+_compile_kilocode_helper_impl() {
+  local HELPER_SRC="$KARNEL_PATH/tools/ai/kilocode-cli/helper/kilocode_helper.c"
+  if [ ! -f "$HELPER_SRC" ]; then
+    log_error "Helper source not found at $HELPER_SRC"
+    return 1
+  fi
+
+  if ! clang -O2 -o "$PREFIX/bin/kilocode" "$HELPER_SRC" &>>"$LOG_FILE"; then
+    log_error "Failed to compile kilocode helper"
+    return 1
+  fi
+
+  chmod +x "$PREFIX/bin/kilocode"
+
+  ln -sf "$PREFIX/bin/kilocode" "$PREFIX/bin/kilo"
+
+  return 0
+}
+
+_install_kilocode_native() {
+  _install_kilocode_deps || return 1
+  _download_kilocode_binary || return 1
+  _compile_kilocode_helper || return 1
+  log_success "Kilo Code CLI installed natively"
+  return 0
+}
+
+install_kilocode_cli() {
+  if command -v kilocode &>/dev/null; then
+    log_info "Kilo Code CLI is already installed"
+    return 2
+  fi
+
+  _install_kilocode_native
+}
+
+uninstall_kilocode_cli() {
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  if [ ! -f "$PREFIX/bin/kilocode" ]; then
+    log_warn "Kilo Code CLI is not installed"
+    return 1
+  fi
+
+  loading "Uninstalling Kilo Code CLI" _uninstall_kilocode_cli_impl
+}
+
+_uninstall_kilocode_cli_impl() {
+  if [ -f "$KILOCODE_DATA_DIR/kilo" ]; then
+    rm -f "$PREFIX/bin/kilocode" "$PREFIX/bin/kilo"
+    rm -rf "$KILOCODE_DATA_DIR"
+    log_success "Kilo Code CLI uninstalled"
+    return 0
+  fi
+
+  if rm -f "$PREFIX/bin/kilocode" "$PREFIX/bin/kilo" &>>"$LOG_FILE"; then
+    log_success "Kilo Code CLI uninstalled"
+    return 0
+  else
+    log_error "Failed to uninstall Kilo Code CLI"
+    return 1
+  fi
+}
+
+update_kilocode_cli() {
+  mkdir -p "$(dirname "$LOG_FILE")"
+
+  if [ -f "$KILOCODE_DATA_DIR/kilo" ]; then
+    _install_kilocode_native
+    return $?
+  fi
+
+  log_warn "Kilo Code CLI not found for update"
+  return 1
+}
+
+reinstall_kilocode_cli() {
+  uninstall_kilocode_cli
+  install_kilocode_cli
+}

package/karnel/tools/ai/kimchi-code/README.md

@@ -0,0 +1,53 @@
+# Kimchi CLI
+
+Terminal coding agent powered by Kimchi's multi-model orchestration by CAST AI.
+
+**Package:** kimchi-code  
+**Author:** israel marques  
+**Repository:** https://github.com/israelmarques1024-dotcom/karnel-termux  
+**Official:** https://github.com/getkimchi/kimchi  
+**Type:** AI coding agent (Binary download)  
+**License:** MIT
+
+## Description
+
+Kimchi is a standalone terminal coding agent — not an OpenCode plugin. It configures AI coding assistants to use CAST AI's open-source models. Terminal coding agent powered by Kimchi's multi-model orchestration.
+
+## Dependencies
+
+- curl, tar
+- proot-distro (for Termux/Android)
+
+## Install
+
+```bash
+karnel install ai --kimchi-code
+```
+
+## Uninstall
+
+```bash
+karnel uninstall ai --kimchi-code
+```
+
+## Update
+
+```bash
+karnel update ai --kimchi-code
+```
+
+## Usage
+
+```bash
+kimchi                    # Launch interactive TUI
+kimchi setup              # First-time configuration wizard
+```
+
+## Notes
+
+- Binary downloaded from GitHub releases: `getkimchi/kimchi`
+- Command: `kimchi`
+- Data directory: `~/.local/share/karnel-data/kimchi/`
+- Runs inside proot-distro Ubuntu on Termux for glibc compatibility
+- Switch model with `/model` or `Ctrl+P`
+- Docs: https://docs.kimchi.dev