GURU-Ai

在 Termux 里一键跑起 AI 助手,还能生成二维码分享

GURU-Ai 是一个基于 JavaScript 的对话助手项目,定位为“简单又复杂”的智能交互工具。它主要解决用户在移动端(尤其是 Termux 环境)快速部署和使用 AI 对话能力的问题,同时集成二维码生成与自动化功能,让 AI 服务更易触达。项目核心能力包括:通过 OpenAI 兼容接口实现智能对话,支持在 Termux 终端中运行,提供二维码生成便于移动端分享,并具备一定的自动化流程能力。它旨在降低 AI 应用的门槛,让开发者或极客能在低配设备上快速搭建个人 AI 助手,适合实验性项目和轻量级场景。

开源 unknown 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1167
维护状态 低维护
是否开源 是
定价模式 unknown

项目数据

分类对话助手
开发团队Guru322
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源是
开源协议NOASSERTION
主要语言JavaScript
技术栈/模型ai,automation,chatgpt,openai,qrcode,termux
GitHub 星标★ 1167
30天Star增速
HF 下载量
上线时间2022-11-25 00:00:00
最近更新2026-09-21 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数3

使用教程

难度:进阶 约 15 分钟 部署方式:本地安装 7 步

环境要求

  • 已安装 Node.js 与 npm(建议 LTS 版本)
  • 一个可用的 MongoDB 连接串(MONGODB_URI)
  • 一个带国家码的 WhatsApp 手机号(PHONE_NUMBER)
  • 默认占用 5000 端口,可通过 PORT 环境变量修改
  • 需要能访问 GitHub 与 npm 仓库的网络环境(Termux 亦可)

安装与启动步骤

  1. 1克隆项目代码

    把 GURU-Ai 仓库拉到本地,命令执行后会生成 GURU-Ai 目录。

    git clone https://github.com/Guru322/GURU-Ai.git
  2. 2进入项目目录

    切换到刚克隆下来的项目根目录,后续命令都在此目录执行。

    cd GURU-Ai
  3. 3安装依赖

    按 package.json 安装 Node 依赖,网络慢时可能耗时较久,请耐心等待。

    npm install
  4. 4配置环境变量

    在项目根目录新建 .env 文件,填入 MongoDB 连接串、WhatsApp 手机号、机器人名称与所有者列表。

    cat > .env << 'EOF'
    MONGODB_URI=mongodb+srv://user:pass@cluster0.mongodb.net/gurudb
    PHONE_NUMBER=919876543210
    BOTNAME=GURU-Ai
    OWNERS="owner1;john;owner2;doe"
    EOF
  5. 5可选:调整 config.js

    README 说明可在 config.js 中修改机器人名、包名、作者、owners 列表和贴纸水印等额外设置。

  6. 6启动机器人

    用 npm start 或 node index.js 启动,默认监听 5000 端口(或 PORT 指定的端口)。

    npm start
  7. 7浏览器访问验证

    启动后打开浏览器访问 http://localhost:5000 查看服务页面。

关键配置

配置项必填说明示例
MONGODB_URI是MongoDB 数据库连接地址,用于持久化数据mongodb+srv://user:pass@cluster0.mongodb.net/gurudb
PHONE_NUMBER是WhatsApp 手机号,需带国家码919876543210
BOTNAME否机器人的显示名称,可选GURU-Ai
OWNERS否所有者列表,分号分隔的多个名称"owner1;john;owner2;doe"
PORT否服务监听端口,不设置时默认 50005000

如何确认成功

终端无报错且进程保持运行,浏览器打开 http://localhost:5000 能正常显示页面,即启动成功。

常见问题

Q:一定要用 .env 文件吗?

A:不强制。README 说明既可以在项目根目录创建 .env 文件,也可以直接设置同名环境变量,两种方式都行。

Q:浏览器打不开 http://localhost:5000 怎么办?

A:确认进程仍在运行、端口未被占用;若改了 PORT,请用对应端口访问,也可在 Termux 中确认本地端口监听情况。

Q:启动报 MongoDB 相关错误?

A:检查 MONGODB_URI 是否填写完整、账号密码是否正确、数据库是否允许当前网络访问。

Q:可以用 node index.js 启动吗?

A:可以,README 明确 npm start 与 node index.js 两者等效,任选其一。

注意事项

  • README 中 .env 的 OWNERS 值是带引号的分号分隔列表,填写时注意保留引号格式。
  • 默认端口为 5000,若被占用请通过 PORT 环境变量修改后再启动。
  • 除环境变量外,还可编辑 config.js 调整机器人名称、包名、作者与贴纸水印等设置。
  • 该环境变量列表看起来同时具备 WhatsApp 机器人特征,使用前请确认账号合规与风险。

核心亮点

  • 专为 Termux 优化,在手机终端即可部署运行,极大降低硬件门槛
  • 集成二维码生成,方便快速分享对话或配置,实用性强
  • 代码结构简洁,基于 JavaScript,易于二次开发和定制

不足之处

  • 功能相对单一,主要聚焦对话和二维码,复杂场景支持有限
  • 文档和社区生态尚不完善,上手可能需要自行摸索

适用场景

  • 在安卓手机上通过 Termux 快速搭建个人 AI 聊天机器人
  • 为线下活动或演示生成包含 AI 对话入口的二维码
  • 作为学习 OpenAI API 和自动化集成的轻量级参考项目

替代项目

chatbot-ui、open-webui、LibreChat

项目介绍

GURU-Ai 是自动化工作流领域的开源项目,由 Guru322 开发,2022 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(1,167)位列前 30%,在自动化工作流分类中处于中上游。

项目已超过三个月没有代码更新,维护节奏明显放缓,最近一次代码更新于 2026-09-21。从国内网络环境看,可直接访问。

它主要面向的使用场景是:在安卓手机上通过Termux快速搭建个人AI聊天机器人。同类可对比的替代方案包括 chatbot-ui、open-webui、LibreChat。

上一篇:gpt-promo-scanner

下一篇:ChatGPT-ShellMaster

同类项目推荐

n8n 开源

拖拽搭建自动化流程,轻松接入 AI 与 400+ 应用,搞定重复工作。

Fair-code workflow automation platform with native AI capabilities. Combine visual b···

★ 205700 2026-08-10
feishu-docx 开源

让 AI 代理轻松读写飞书文档,双向转换 Markdown

Feishu/Lark Docs、Sheet、Bitable <-> Markdown | AI Agent-friendly knowledge base exp···

★ 262 2026-08-09
robotcode 开源

让 Robot Framework 拥有现代 IDE 体验,调试、补全、运行一气呵成。

Open Source Toolkit for Robot Framework, providing Language Server Protocol support,···

★ 301 2026-08-10
puppeteer 开源

用 JavaScript 轻松操控无头浏览器,搞定自动化测试与网页抓取。

JavaScript API for Chrome and Firefox

★ 95609 2026-08-10