搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

AbuZar-Ansarii/Needle

AI 工程

在 Termux 里用自然语言控制 Android 手机硬件并做本地查询的轻量智能助手。

207
58
Python
创建于 2 个月前

项目介绍

Needle 是一个运行在 Android Termux 里的轻量智能助手。它接收「打开手电筒」「电池还剩多少」这类自然语言请求,再转换成 Android 硬件和系统 API 调用。除此之外,它还提供本地知识库、离线拍照文档提取、短信与通知分类,以及一个可通过 Telegram 远程控制的机器人。

项目通过 Python 包 cactus-needle 封装 Cactus Compute 的基础模型,支持 Needle 3(默认)和旧版 14 MB Needle 2 两套模型。两套模型可以在运行时切换:Web UI 顶部的模型按钮、CLI 里的 /model 3 或 /model 2、或者 Telegram 消息,都不需要重启服务。Web UI 由 Flask 应用 app.py 提供,另有一个终端界面 termux_needle.py。

快速使用

在已安装 Termux 的 Android 设备上操作。先装好 Termux:API 应用,硬件调用才有可用的桥接层。

pkg update && pkg upgrade
pkg install termux-api python git
pkg install proot-distro
proot-distro install ubuntu
proot-distro login ubuntu

进入 Ubuntu 环境后安装 Python 依赖和仓库:

apt update && apt upgrade -y
apt install git python3 python3-pip python3-venv ca-certificates -y
git clone https://github.com/AbuZar-Ansarii/Needle.git
cd Needle
python3 -m venv myenv
source myenv/bin/activate
pip3 install -r requirements.txt

这一步会安装 cactus-needle>=3.0.0 和 Flask Web 服务。README 说明 app.py 和 termux_needle.py 会在运行时清理从 Termux 继承的 ANDROID_ROOT 与 ANDROID_DATA 变量,让引擎识别 ARM64 Ubuntu 环境并正常加载 README 安装步骤。

启动 Web UI:

python3 app.py

然后在手机浏览器打开 http://127.0.0.1:5000。要使用小模型可运行 python3 app.py --model 2,终端界面用 python termux_needle.py 启动。Telegram 远程控制需要 bot token:python3 app.py --telegram YOUR_BOT_TOKEN README 模型章节。

使用约束

  • 项目面向安装了 Termux:API 应用的 Android/Termux 环境;README 提到可在 Windows/macOS 下用桌面模拟模式,但该模式只是模拟输出层,不会调用真实手机硬件。
  • 安装除了 Termux 包以外,还要在 PRoot 里装一个完整 Ubuntu 环境。cactus-needle 包及其模型下载是仓库之外的外部依赖。
  • 大量指令会接触敏感数据和系统权限:短信、通话记录、联系人、剪贴板、位置、摄像头、麦克风录音、生物识别提示等,需要为 Termux/API 授予对应的 Android 运行时权限。
  • 仓库没有声明许可证,复用和再分发条款不明确。
  • 仓库目前没有 HotRepo 快照或排名记录,缺少采用情况和稳定性数据。

HotRepo 点评

README 的功能面非常宽:手电筒、Wi-Fi、短信、电话、联系人、相机 OCR、3072 维向量知识库、Telegram 远程控制和两个模型间动态切换 项目 README。这意味着 Android 权限面很大,而两个模型尺寸只给了参数,没有基准测试或硬件耗时数据。页面链接了一段 演示视频,但没有延迟或准确率的实测结果。评估这个项目时,建议单独核查 cactus-needle 依赖及其来源,因为仓库本身看起来更像封装层,而不是模型实现。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. guzhou079-arch/deepseek-harness-android把 DeepSeek Harness 打包成安卓 APK,免 Termux、免 root,内置读屏、虚拟屏、定时任务和 27 款技能。JavaScript110
  2. phone-harness/phone-harness让编程 Agent 通过 Python CLI 点击、输入、滚动并读取真实 iPhone 或 Android 手机。Python5,051
  3. ashhart/TensorFold在 Apple Silicon 和 NVIDIA GPU 上原生运行量化 LLM,提供 OpenAI 兼容 API,无需 Python。Zig1,812
  4. browser-use/browser-use让大模型通过 CDP 操控真实浏览器完成网页任务的 Python 库。Python120,670
  5. tapilot-ai/tapilot用自然语言操控 Android 手机执行跨应用任务的实验性应用,依赖视觉模型和 Android 无障碍权限。HTML138