项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1168
技术标签
使用教程
环境要求
- 已安装 Node.js 与 npm(建议 LTS 版本)
- 一个可用的 MongoDB 连接串(MONGODB_URI)
- 一个带国家码的 WhatsApp 手机号(PHONE_NUMBER)
- 默认占用 5000 端口,可通过 PORT 环境变量修改
- 需要能访问 GitHub 与 npm 仓库的网络环境(Termux 亦可)
安装与启动步骤
-
1克隆项目代码
把 GURU-Ai 仓库拉到本地,命令执行后会生成 GURU-Ai 目录。
git clone https://github.com/Guru322/GURU-Ai.git -
2进入项目目录
切换到刚克隆下来的项目根目录,后续命令都在此目录执行。
cd GURU-Ai -
3安装依赖
按 package.json 安装 Node 依赖,网络慢时可能耗时较久,请耐心等待。
npm install -
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可选:调整 config.js
README 说明可在 config.js 中修改机器人名、包名、作者、owners 列表和贴纸水印等额外设置。
-
6启动机器人
用 npm start 或 node index.js 启动,默认监听 5000 端口(或 PORT 指定的端口)。
npm start -
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 | 否 | 服务监听端口,不设置时默认 5000 | 5000 |
如何确认成功
终端无报错且进程保持运行,浏览器打开 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
同类项目推荐
superplane
开源
给 AI 代理工程装上控制台,让自动化流程可控可审计
Open source factory for one-shot engineering
super-board
开源
一行安装,让 Claude Code 自动把看板任务做成代码并自检评审
Autonomous GitHub Project build → QA → review loop for Claude Code. One-line insta···
awesome-n8n-templates
开源
海量现成 n8n 工作流,检索即导入,省去从零搭建
The largest open-source collection of n8n workflow templates — 8,697+ ready-to-impo···
surf
开源
让 Go 请求伪装成真实浏览器,绕过反爬检测
SURF - Advanced Go HTTP client with Chrome/Firefox browser impersonation, HTTP/3 wit···
mobilerun-portal
开源
用大白话指挥手机,AI 帮你自动点按滑
Automate your mobile devices with natural language commands - the counterpart androi···
BrowserOS
开源
让浏览器自己干活,你只管下指令
The open-source Agentic browser; alternative to ChatGPT Atlas, Perplexity Comet, Dia···
invisible_playwright_mcp
开源
让 AI Agent 用隐身浏览器上网,绕过反爬和验证码
Playwright MCP server undetected by anti-bots and captchas: AI agent browses the web···
automatron
开源
在 LINE 聊天里搞定家居、记账和交易提醒
Personal LINE bot to automate various tasks. Home automation, expense tracking, tran···
mercadona-cli
开源
在终端搜商品、比价格、装购物车,还能让 AI 帮你下单
Unofficial, agent-friendly Mercadona shopping CLI (Go) — search products, read pric···
