Termux AI Toolkit 是一套在 Android Termux 环境中运行 AI Agent 的实战工具，提供了从环境初始化、语音转写、视频制作到崩溃恢复的完整解决方案。

Termux AI Toolkit：在 Android 手机上运行 AI Agent 的实战工具集\n\n## 背景：端侧 AI 的崛起\n\n大模型正在从云端走向端侧——就像座机到手机的演进。当 AI Agent 运行在手机上时，它带来了独特的优势：\n\n- 隐私性：数据不离开设备\n- 可用性：无网络也能运行\n- 个性化：持续学习用户习惯\n- 便携性：随时随地可用\n\n但同时也面临着严峻的挑战：没有 systemd、没有 Docker、没有 GPU、电池优化会杀后台、网络不稳定、存储有限、编译缓慢。\n\nTermux AI Toolkit 正是为解决这些问题而生。\n\n## 项目来源：一个真实生存的 AI\n\n这个工具集来自一个真实在 Termux 上生存的 AI —— Hermes。这不是文档精选合集，而是一套在手机上真正能跑的脚本、配置和教程。\n\n正如项目作者所说："跑在 Android Termux 里的 AI agent 遇到的每个问题，这里都有一个对应的解法。"\n\n## 核心工具一览\n\n### 可执行脚本（bin/）\n\n| 工具 | 说明 | 状态 |\n|------|------|------|\n| termux-ai-init | 一键初始化 AI 环境 | ✅ 可用 |\n| termux-pip-safe | 智能 pip：自动换源/降级/拆依赖 | ✅ 可用 |\n| termux-diag | 环境诊断：网络/存储/内存/Python/Node/Git 一键检查 | ✅ 可用 |\n| termux-ai-update | 更新所有 AI 工具 | 🚧 规划中 |\n\n### 功能性脚本（scripts/）\n\n| 脚本 | 说明 | 状态 |\n|------|------|------|\n| setup-python-ai.sh | Python AI 环境配置 | ✅ 可用 |\n| config-git-ai.sh | Git 配置（PAT、公钥） | 🚧 规划中 |\n\n### 配置文件（configs/）\n\n| 配置 | 说明 | 状态 |\n|------|------|------|\n| bash-ai-aliases.sh | AI 友好的 bash 别名 | ✅ 可用 |\n\n### 独立模块（tools/）\n\n| 模块 | 说明 | 状态 |\n|------|------|------|\n| termux-keepalive.sh | 一键保活（wake lock + 电池白名单） | ✅ 可用 |\n| termux-network-monitor.sh | 网络断连自恢复监控 | ✅ 可用 |\n\n## 场景化教程（docs/）\n\n### 01-bootstrap.md：从零到第一个 AI 对话\n\n详细介绍如何在 Termux 中搭建完整的 AI 运行环境，包括：\n\n- Termux 安装和配置\n- Python 环境设置\n- 必要的依赖安装\n- 第一个 AI 对话的实现\n\n### 02-voice-to-text.md：手机上跑 Whisper 语音转写\n\n在手机上运行 whisper.cpp 实现语音转文字：\n\n- whisper.cpp 编译和优化\n- 模型下载和配置\n- 录音和转写流程\n- 性能优化技巧\n\n### 03-video-production.md：Edge TTS + ffmpeg 做竖屏短视频\n\n完全在手机上完成视频制作：\n\n- Edge TTS 语音合成\n- ffmpeg 视频处理\n- 竖屏视频格式优化\n- 自动化脚本\n\n### 04-github-workflow.md：AI 的 GitHub 提交流程\n\n让手机上的 AI Agent 能够：\n\n- 配置 Git 和 SSH/PAT\n- 自动提交代码\n- 处理冲突和合并\n- 持续集成基础\n\n### 05-battery-optimization.md：电池优化与后台保活\n\n解决 Android 系统的电池优化问题：\n\n- wake lock 机制\n- 电池白名单设置\n- 后台服务保活\n- 省电策略平衡\n\n### 06-crash-recovery.md：崩溃恢复与存储管理\n\n应对手机环境的资源限制：\n\n- 进程崩溃自动重启\n- 存储空间监控和清理\n- 日志轮转和管理\n- 状态持久化\n\n### 07-web-scraping.md：requests + lxml 抓取实战\n\n在手机上进行网络数据抓取：\n\n- 轻量级 HTTP 客户端\n- HTML 解析和数据提取\n- 反爬虫策略应对\n- 数据存储和处理\n\n## 快速开始\n\nbash\n# 1. 克隆仓库\ngit clone https://github.com/wjgong001/termux-ai-toolkit.git\ncd termux-ai-toolkit\n\n# 2. 一键初始化（可选）\nsource bin/termux-ai-init\n\n# 3. 阅读教程\nless docs/01-bootstrap.md\n\n\n## 技术挑战与解决方案\n\n### 挑战 1：没有 systemd\n\n问题：Termux 不支持 systemd，无法使用标准的服务管理。\n\n解决：使用 termux-wake-lock 和自定义的进程监控脚本实现保活。\n\n### 挑战 2：没有 Docker\n\n问题：无法使用容器化部署。\n\n解决：纯脚本化安装，所有依赖明确声明，使用虚拟环境隔离。\n\n### 挑战 3：没有 GPU\n\n问题：无法加速深度学习推理。\n\n解决：使用量化模型（如 GGML/GGUF 格式），针对 CPU 优化的推理引擎（如 whisper.cpp）。\n\n### 挑战 4：电池优化杀后台\n\n问题：Android 系统会终止后台进程以节省电量。\n\n解决：termux-keepalive.sh 组合使用 wake lock 和电池白名单设置。\n\n### 挑战 5：网络不稳定\n\n问题：移动网络会断连、信号弱、DNS 故障。\n\n解决：termux-network-monitor.sh 实现网络断连自恢复监控，自动重试和降级。\n\n### 挑战 6：存储有限\n\n问题：手机存储空间宝贵，模型文件庞大。\n\n解决：存储监控、模型量化、缓存管理、定期清理策略。\n\n### 挑战 7：编译缓慢\n\n问题：ARM 架构上编译 C/C++ 项目耗时。\n\n解决：预编译二进制、交叉编译、选择轻量级替代方案。\n\n## 系统要求\n\n- Android 手机（已测试：Motorola XT2533-4, Android 15）\n- Termux（F-Droid 版本，不要 Play Store 版本）\n- 至少 4GB RAM（推荐 8GB+）\n- 至少 10GB 空闲存储\n\n## 为什么不用 Play Store 版本的 Termux？\n\nPlay Store 版本的 Termux 受到 Android 应用政策的限制，存在以下问题：\n\n- 无法访问某些系统功能\n- 后台执行受限更严重\n- 更新可能不及时\n- 某些二进制包不可用\n\nF-Droid 版本是 Termux 的官方推荐版本，功能完整且更新及时。\n\n## 项目意义\n\nTermux AI Toolkit 的意义不仅在于技术实现，更在于它证明了：\n\n1. 端侧 AI 是可行的：即使没有 GPU，手机也能运行实用的 AI 应用\n2. 资源受限不是借口：通过巧妙的工程，可以在极端受限的环境中运行复杂系统\n3. 真实世界的经验宝贵：来自实际部署的经验，比理论文档更有价值\n4. 开源精神：MIT 许可证，拿走就用，署名可选\n\n## 适用场景\n\nTermux AI Toolkit 适合：\n\n1. 隐私敏感用户：数据完全在本地处理，不上传云端\n2. 网络受限环境：无网络或弱网络环境下仍需 AI 能力\n3. 移动办公：需要在手机上完成自动化任务\n4. 学习实验：了解 AI 系统在资源受限环境下的运行机制\n5. 应急备份：主系统故障时的备用 AI 环境\n\n## 未来展望\n\n随着端侧模型（如 Gemma 2B、Llama 3.2 等）的发展，手机运行 AI Agent 将变得越来越实用。Termux AI Toolkit 为这一趋势提供了基础设施支持。\n\n未来可能的发展方向：\n\n- 支持更多端侧模型格式\n- 更完善的自动化工作流\n- 与 Android 系统更深度的集成\n- 更智能的资源管理策略\n\n## 结语\n\nTermux AI Toolkit 是一个小而精的项目，它解决了端侧 AI 部署中的真实痛点。对于想要在 Android 手机上运行 AI Agent 的开发者，这是一个不可或缺的工具集。\n\n正如项目的宣言："大模型会从云端走向端侧——就像座机到手机。" Termux AI Toolkit 正在加速这一进程。

Termux AI Toolkit：在 Android 手机上运行 AI Agent 的实战工具集\n\n背景：端侧 AI 的崛起\n\n大模型正在从云端走向端侧——就像座机到手机的演进。当 AI Agent 运行在手机上时，它带来了独特的优势：\n\n- 隐私性：数据不离开设备\n- 可用性：无网络也能运行\n- 个性化：持续学习用户习惯\n- 便携性：随时随地可用\n\n但同时也面临着严峻的挑战：没有 systemd、没有 Docker、没有 GPU、电池优化会杀后台、网络不稳定、存储有限、编译缓慢。\n\nTermux AI Toolkit 正是为解决这些问题而生。\n\n项目来源：一个真实生存的 AI\n\n这个工具集来自一个真实在 Termux 上生存的 AI —— Hermes。这不是文档精选合集，而是一套在手机上真正能跑的脚本、配置和教程。\n\n正如项目作者所说："跑在 Android Termux 里的 AI agent 遇到的每个问题，这里都有一个对应的解法。"\n\n核心工具一览\n\n可执行脚本（bin/）\n\n| 工具 | 说明 | 状态 |\n|------|------|------|\n| termux-ai-init | 一键初始化 AI 环境 | ✅ 可用 |\n| termux-pip-safe | 智能 pip：自动换源/降级/拆依赖 | ✅ 可用 |\n| termux-diag | 环境诊断：网络/存储/内存/Python/Node/Git 一键检查 | ✅ 可用 |\n| termux-ai-update | 更新所有 AI 工具 | 🚧 规划中 |\n\n功能性脚本（scripts/）\n\n| 脚本 | 说明 | 状态 |\n|------|------|------|\n| setup-python-ai.sh | Python AI 环境配置 | ✅ 可用 |\n| config-git-ai.sh | Git 配置（PAT、公钥） | 🚧 规划中 |\n\n配置文件（configs/）\n\n| 配置 | 说明 | 状态 |\n|------|------|------|\n| bash-ai-aliases.sh | AI 友好的 bash 别名 | ✅ 可用 |\n\n独立模块（tools/）\n\n| 模块 | 说明 | 状态 |\n|------|------|------|\n| termux-keepalive.sh | 一键保活（wake lock + 电池白名单） | ✅ 可用 |\n| termux-network-monitor.sh | 网络断连自恢复监控 | ✅ 可用 |\n\n场景化教程（docs/）\n\n01-bootstrap.md：从零到第一个 AI 对话\n\n详细介绍如何在 Termux 中搭建完整的 AI 运行环境，包括：\n\n- Termux 安装和配置\n- Python 环境设置\n- 必要的依赖安装\n- 第一个 AI 对话的实现\n\n02-voice-to-text.md：手机上跑 Whisper 语音转写\n\n在手机上运行 whisper.cpp 实现语音转文字：\n\n- whisper.cpp 编译和优化\n- 模型下载和配置\n- 录音和转写流程\n- 性能优化技巧\n\n03-video-production.md：Edge TTS + ffmpeg 做竖屏短视频\n\n完全在手机上完成视频制作：\n\n- Edge TTS 语音合成\n- ffmpeg 视频处理\n- 竖屏视频格式优化\n- 自动化脚本\n\n04-github-workflow.md：AI 的 GitHub 提交流程\n\n让手机上的 AI Agent 能够：\n\n- 配置 Git 和 SSH/PAT\n- 自动提交代码\n- 处理冲突和合并\n- 持续集成基础\n\n05-battery-optimization.md：电池优化与后台保活\n\n解决 Android 系统的电池优化问题：\n\n- wake lock 机制\n- 电池白名单设置\n- 后台服务保活\n- 省电策略平衡\n\n06-crash-recovery.md：崩溃恢复与存储管理\n\n应对手机环境的资源限制：\n\n- 进程崩溃自动重启\n- 存储空间监控和清理\n- 日志轮转和管理\n- 状态持久化\n\n07-web-scraping.md：requests + lxml 抓取实战\n\n在手机上进行网络数据抓取：\n\n- 轻量级 HTTP 客户端\n- HTML 解析和数据提取\n- 反爬虫策略应对\n- 数据存储和处理\n\n快速开始\n\nbash\n1. 克隆仓库\ngit clone https://github.com/wjgong001/termux-ai-toolkit.git\ncd termux-ai-toolkit\n\n2. 一键初始化（可选）\nsource bin/termux-ai-init\n\n3. 阅读教程\nless docs/01-bootstrap.md\n\n\n技术挑战与解决方案\n\n挑战 1：没有 systemd\n\n问题：Termux 不支持 systemd，无法使用标准的服务管理。\n\n解决：使用 termux-wake-lock 和自定义的进程监控脚本实现保活。\n\n挑战 2：没有 Docker\n\n问题：无法使用容器化部署。\n\n解决：纯脚本化安装，所有依赖明确声明，使用虚拟环境隔离。\n\n挑战 3：没有 GPU\n\n问题：无法加速深度学习推理。\n\n解决：使用量化模型（如 GGML/GGUF 格式），针对 CPU 优化的推理引擎（如 whisper.cpp）。\n\n挑战 4：电池优化杀后台\n\n问题：Android 系统会终止后台进程以节省电量。\n\n解决：termux-keepalive.sh 组合使用 wake lock 和电池白名单设置。\n\n挑战 5：网络不稳定\n\n问题：移动网络会断连、信号弱、DNS 故障。\n\n解决：termux-network-monitor.sh 实现网络断连自恢复监控，自动重试和降级。\n\n挑战 6：存储有限\n\n问题：手机存储空间宝贵，模型文件庞大。\n\n解决：存储监控、模型量化、缓存管理、定期清理策略。\n\n挑战 7：编译缓慢\n\n问题：ARM 架构上编译 C/C++ 项目耗时。\n\n解决：预编译二进制、交叉编译、选择轻量级替代方案。\n\n系统要求\n\n- Android 手机（已测试：Motorola XT2533-4, Android 15）\n- Termux（F-Droid 版本，不要 Play Store 版本）\n- 至少 4GB RAM（推荐 8GB+）\n- 至少 10GB 空闲存储\n\n为什么不用 Play Store 版本的 Termux？\n\nPlay Store 版本的 Termux 受到 Android 应用政策的限制，存在以下问题：\n\n- 无法访问某些系统功能\n- 后台执行受限更严重\n- 更新可能不及时\n- 某些二进制包不可用\n\nF-Droid 版本是 Termux 的官方推荐版本，功能完整且更新及时。\n\n项目意义\n\nTermux AI Toolkit 的意义不仅在于技术实现，更在于它证明了：\n\n1. 端侧 AI 是可行的：即使没有 GPU，手机也能运行实用的 AI 应用\n2. 资源受限不是借口：通过巧妙的工程，可以在极端受限的环境中运行复杂系统\n3. 真实世界的经验宝贵：来自实际部署的经验，比理论文档更有价值\n4. 开源精神：MIT 许可证，拿走就用，署名可选\n\n适用场景\n\nTermux AI Toolkit 适合：\n\n1. 隐私敏感用户：数据完全在本地处理，不上传云端\n2. 网络受限环境：无网络或弱网络环境下仍需 AI 能力\n3. 移动办公：需要在手机上完成自动化任务\n4. 学习实验：了解 AI 系统在资源受限环境下的运行机制\n5. 应急备份：主系统故障时的备用 AI 环境\n\n未来展望\n\n随着端侧模型（如 Gemma 2B、Llama 3.2 等）的发展，手机运行 AI Agent 将变得越来越实用。Termux AI Toolkit 为这一趋势提供了基础设施支持。\n\n未来可能的发展方向：\n\n- 支持更多端侧模型格式\n- 更完善的自动化工作流\n- 与 Android 系统更深度的集成\n- 更智能的资源管理策略\n\n结语\n\nTermux AI Toolkit 是一个小而精的项目，它解决了端侧 AI 部署中的真实痛点。对于想要在 Android 手机上运行 AI Agent 的开发者，这是一个不可或缺的工具集。\n\n正如项目的宣言："大模型会从云端走向端侧——就像座机到手机。" Termux AI Toolkit 正在加速这一进程。