贾维斯

一款适用于 Linux、MacOS 和 Windows 的个人非 AI 助手

贾维斯是一款简单的个人助手，支持 Linux、MacOS 和 Windows 操作系统，并通过命令行界面运行。如果你启用语音功能，他还能与你对话。他可以为你提供天气信息，帮你查找附近的餐馆和其他场所，还能完成许多其他实用任务。

🚀 贾维斯可以为你做的 15+ 种不同任务：

1. 娱乐与建议

   • 当你感到无聊时提供建议（activity、bored）
   • 提供绘画、观看或聆听内容的灵感（prompt、top_media、taste dive、mood music）

2. 体育资讯

   • 获取最新的体育信息：球队排名、比赛时间、球员数据（basketball、cricket、soccer、tennis）

3. 游戏

   • 玩各种游戏：二十一点、四子棋、猜字游戏、石头剪刀布等（blackjack、connect_four、guess_number_game、hangman、rockpaperscissors、roulette、tic_tac_toe、word_game、wordle）

4. 健康与健身

   • 查阅营养成分、食谱、锻炼计划和健康追踪工具（bmi、bmr、calories、food recipe、fruit、fruit nutrition、workout）

5. 鸡尾酒配方

   • 学习如何调制鸡尾酒（cocktail、drink）

6. 随机生成器

   • 生成随机列表、数字和密码（random list、random number、random password）

7. 单位转换

   • 进行单位换算：二进制、货币、十六进制、长度、质量、速度、温度、时间（binary、currencyconv、hex、lengthconv、massconv、speedconv、string_convert、tempconv、timeconv）

8. 摄影

   • 拍摄照片和截图（open camera、screencapture）

9. 系统信息

   • 获取电脑硬件规格（battery、cat his、dns forward、dns reverse、hostinfo、ip、scan_network、speedtest、os、check ram、systeminfo）

10. 文件管理

    • 管理和整理文件（file manage、file organize）

11. 图像处理

    • 上传、编辑和转换图片（imgur、image to pdf、image compressor）

12. PDF 转换

    • 将网页转换为 PDF 或将 PDF 转换为图片（htmltopdf、pdf to images）

13. 笑话与趣闻

    • 分享笑话和随机趣闻（dadjoke、joke daily、joke chuck、joke、fact、cat fact）

14. 计算

    • 执行计算和解方程（calculate、factor、solve、equations、plot、matrix add）

15. 生成二维码

    • 为 URL 生成二维码（qr）

16. 天气预报

    • 查询天气预报（weather report）

17. 语言翻译

    • 翻译语言（translate）

18. 股市信息

    • 显示股票和加密货币信息（stock、cryptotracker）

🛠️ 开始使用

安装

1. 克隆仓库

   git clone https://github.com/sukeesh/Jarvis.git
   

2. 运行安装程序

   python installer
   

   如果上述命令无效，请尝试：

   python3 installer
   

运行贾维斯

• 从任何位置运行贾维斯：

  jarvis
  

  或者在项目目录内运行：

  ./jarvis
  

你可以先在贾维斯命令行中输入 help，查看贾维斯能为你做些什么。

❓常见问题解答

问题：
当我运行贾维斯时，出现“模块未找到”的错误。

平台：
Windows

解决方案 1：卸载并重新安装相关模块包。

示例：
错误：ImportError: DLL load failed while importing win32api: The specified module could not be found.

解决方案：
pip uninstall pywin32
pip install pywin32 或 conda install pywin32

解决方案 2：将该包添加到你的环境变量系统 PATH 中。

---

问题：
在终端克隆仓库后，运行 python3 installer 时提示需要安装虚拟环境。

解决方案：

• 使用以下命令安装虚拟环境：

  python3 -m pip install virtualenv
  

• 或者：在 Linux 上使用包管理器（例如 Ubuntu 执行 sudo apt install python3-venv）。

• 重新启动安装程序。

---

如果你遇到其他问题，或者已经找到了解决方法，请随时补充到此列表中！

💻 展示贾维斯的 YouTube 视频

点击这里

🤝 参与贡献

请查看我们的 CONTRIBUTING.md，了解如何参与贡献！

快速入门：创建新功能（插件）

在 custom/hello_world.py 文件中创建新插件：

from plugin import plugin


@plugin("helloworld")
def helloworld(jarvis, s):
    """重复你输入的内容"""
    jarvis.say(s)

试试看吧！

./jarvis
贾维斯的语音功能默认关闭。若要让贾维斯大声说话，请输入：enable sound
输入 'help' 查看可用命令列表。

~> 你好，有什么可以帮您的吗？
helloworld 贾维斯真酷！
贾维斯真酷

插件

点击这里 了解更多关于插件的信息。

编写测试

编写测试是可选的，但绝对是个好主意；）。

点击这里 了解有关测试的更多信息。

如何运行测试：

运行 test.sh

./test.sh

可选依赖项

• 任何 pyttsx3 文本转语音引擎（sapi5、nsss 或 espeak），以便贾维斯能够大声说话（例如，在 Ubuntu 上执行 sudo apt install espeak）
• Portaudio + python-devel 包，用于语音控制
• 在 Linux 上安装 notify-send，以便接收美观的桌面通知，而不是难看的弹出窗口（例如，在 Ubuntu 上执行 sudo apt install libnotify-bin）
• 如果希望下载音乐时得到 .mp3 格式而非 .webm 格式，需安装 ffmpeg

Docker

使用 Docker 运行（需已安装并运行 Docker）：

[sudo] make build_docker
[sudo] make run_docker

作者

sukeesh

另请参阅参与本项目的 贡献者列表。

许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。

Jarvis 快速上手指南

Jarvis 是一款适用于 Linux、macOS 和 Windows 的命令行个人助手。虽然它被标记为“非 AI"，但它能通过插件系统执行超过 15 类实用任务，包括天气查询、单位换算、系统信息获取、娱乐游戏及文件管理等。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Linux, macOS, 或 Windows
• Python 版本：推荐 Python 3.x
• Git：用于克隆代码仓库
• 可选依赖（按需安装）：
  • 语音功能：需安装 pyttsx3 引擎（如 Ubuntu 下安装 espeak：sudo apt install espeak）。
  • 语音控制：需安装 Portaudio 和 python-devel。
  • 桌面通知（Linux）：安装 libnotify-bin (sudo apt install libnotify-bin) 以获得更美观的通知。
  • 音乐下载：安装 ffmpeg 以支持 mp3 格式下载。

提示：国内用户若遇到 pip 安装缓慢，建议在安装依赖前配置国内镜像源（如清华源或阿里源）。

安装步骤

1. 克隆仓库

打开终端，运行以下命令下载项目源码：

git clone https://github.com/sukeesh/Jarvis.git
cd Jarvis

2. 运行安装脚本

执行安装程序以自动配置虚拟环境和依赖项：

python installer

如果上述命令无效（例如在某些 Linux 发行版中），请尝试：

python3 installer

注意：如果安装脚本报错提示需要虚拟环境，请先手动安装：

python3 -m pip install virtualenv
# 或者在 Ubuntu/Debian 上
sudo apt install python3-venv

然后重新运行安装脚本。

基本使用

启动 Jarvis

安装完成后，您可以通过以下任一方式启动：

方式一：在任何目录下运行

jarvis

方式二：在项目文件夹内运行

./jarvis

简单交互示例

启动后，您将看到欢迎界面。默认情况下语音功能是关闭的。

1. 查看帮助：输入 help 查看所有可用指令列表。
2. 启用语音（可选）：输入 enable sound 让 Jarvis 开口说话。
3. 执行任务：直接输入指令即可。

示例对话：

~> Hi, what can I do for you?
weather report Beijing
# Jarvis 将显示北京的天气预报

~> What else can I do for you?
joke
# Jarvis 将讲一个笑话

~> What else can I do for you?
calculate 12 * 58
# Jarvis 将输出计算结果

~> What else can I do for you?
exit
# 退出程序

自定义插件（进阶）

您可以轻松创建自己的插件。在项目目录下的 custom 文件夹中新建一个 Python 文件（例如 hello_world.py）：

from plugin import plugin

@plugin("helloworld")
def helloworld(jarvis, s):
    """Repeats what you type"""
    jarvis.say(s)

保存后重启 Jarvis，即可通过输入 helloworld Jarvis is cool! 来测试新功能。