GURU-Ai

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

开源 🏷️定价信息待确认 ✅ 目前可打开 对话助手 🍴 复刻 8275 🐛 待处理 18 👀 关注 14
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1168
维护状态 低维护
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

GURU-Ai 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类对话助手
开发团队Guru322
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议NOASSERTION
主要语言JavaScript
技术栈/模型ai,automation,chatgpt,openai,qrcode,termux
GitHub 星标★ 1168
上线时间2022-11-25 00:00:00
代码更新2026-04-15
仓库体积10.9 MB
本站数据更新2026-11-11
维护状态低维护
收录时间2026-08-09
浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1168

技术标签

使用教程

难度:进阶 约 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

上一篇:gpt-promo-scanner

下一篇:ChatGPT-ShellMaster

同类项目推荐

superplane 开源

给 AI 代理工程装上控制台,让自动化流程可控可审计

Open source factory for one-shot engineering

★ 10020 2026-08-10
super-board 开源

一行安装,让 Claude Code 自动把看板任务做成代码并自检评审

Autonomous GitHub Project build → QA → review loop for Claude Code. One-line insta···

★ 656 2026-10-18
awesome-n8n-templates 开源

海量现成 n8n 工作流,检索即导入,省去从零搭建

The largest open-source collection of n8n workflow templates — 8,697+ ready-to-impo···

★ 119 2026-10-27
surf 开源

让 Go 请求伪装成真实浏览器,绕过反爬检测

SURF - Advanced Go HTTP client with Chrome/Firefox browser impersonation, HTTP/3 wit···

★ 1853 2026-10-08
mobilerun-portal 开源

用大白话指挥手机,AI 帮你自动点按滑

Automate your mobile devices with natural language commands - the counterpart androi···

★ 407 2026-08-09
BrowserOS 开源

让浏览器自己干活,你只管下指令

The open-source Agentic browser; alternative to ChatGPT Atlas, Perplexity Comet, Dia···

★ 14311 2026-08-09
invisible_playwright_mcp 开源

让 AI Agent 用隐身浏览器上网,绕过反爬和验证码

Playwright MCP server undetected by anti-bots and captchas: AI agent browses the web···

★ 878 2026-09-28
automatron 开源

在 LINE 聊天里搞定家居、记账和交易提醒

Personal LINE bot to automate various tasks. Home automation, expense tracking, tran···

★ 180 2026-08-09
mercadona-cli 开源

在终端搜商品、比价格、装购物车,还能让 AI 帮你下单

Unofficial, agent-friendly Mercadona shopping CLI (Go) — search products, read pric···

★ 338 2026-10-18