关于贾维斯 - 一种智能AI意识 🧠

贾维斯是一款基于Python 3.8的语音命令助手服务。 它可以识别人类语音、与用户对话并执行基本命令。

需求

• 操作系统：Ubuntu 20.04 (Focal Fossa)
• Python版本：3.8.x

助手技能

• 打开网页（例如“贾维斯，打开YouTube”）
• 在YouTube上播放音乐（例如“贾维斯，播放莫扎特”）
• 调节扬声器音量（可调高或调低，也可设置最大音量或静音）（例如“贾维斯，音量调大！”）
• 打开LibreOffice套件中的应用程序（Calc、Writer、Impress）（例如“贾维斯，打开Calc”）
• 通过网络搜索回答问题（例如“贾维斯，给我讲讲橙子”）
• 查询某地天气（例如“贾维斯，告诉我伦敦的天气”）
• 显示当前时间和/或日期（例如“贾维斯，告诉我时间或日期”）
• 设置闹钟（例如“贾维斯，创建一个新闹钟”）
• 检测网络速度（ping、上行和下行）（例如“贾维斯，告诉我网络速度”）
• 检查网络连接状态（例如“贾维斯，网络连接正常吗？”）
• 播报每日新闻（例如“贾维斯，告诉我今天的新闻”）
• 拼写单词（例如“贾维斯，帮我拼写‘animal’这个词”）
• 创建提醒（例如“贾维斯，创建一个10分钟的提醒”）
• 打开Linux应用程序（例如“贾维斯，打开Bash/Firefox”）
• 列出所有可用技能（例如“贾维斯，告诉我你的技能”或“贾维斯，你能做什么？”）
• 显示当前位置（例如“贾维斯，告诉我你现在的位置”）
• 显示内存占用情况（例如“贾维斯，告诉我你的内存使用情况”）
• 显示用户命令历史（例如“贾维斯，告诉我我的历史”）
• 记录/学习新指令并启用学习模式，按需添加新回复！（例如“贾维斯，记住”）
• 清空终端界面（例如“贾维斯，清空终端”）
• 提供帮助命令，打印所有技能及其描述（例如“贾维斯，帮助”）
• 进行基础计算（例如“贾维斯，(5 + 6) * 8”或“贾维斯，一加一”）
• 运行时更改设置（例如“贾维斯，更改设置”）

助手特性

• 异步执行命令及语音识别与解析
• 支持两种不同的用户输入方式（文本或语音），用户可以选择打字或对着麦克风说话。
• 在一般性问题上作出回答（通过调用Wolfram API），例如（“贾维斯，告诉我最高的建筑”）
• 运行时切换输入模式，通过特定短语触发，例如“贾维斯，更改设置”）
• 易于自定义语音命令
• 可配置助手名称（例如“贾维斯”、“索菲亚”、“约翰”等）（支持运行时更改）
• 控制台中提供日志预览
• 语音和/或文本回复
• 将命令历史和已学习技能保存在MongoDB中。

快速入门

创建第三方API密钥

贾维斯助手使用第三方API进行语音识别、网络信息检索、天气预报等操作。 以下所有API均提供免费的非商业用途调用权限。请注册以下API以获取免费访问密钥。

• OpenWeatherMap：用于天气预报的API。
• WolframAlpha：用于回答问题的API。
• IPSTACK：用于获取当前位置的API。

在Ubuntu/Debian系统中设置贾维斯

• 克隆贾维斯仓库到本地：

git clone https://github.com/ggeop/Jarvis.git --branch master

对于贡献者：

git clone https://github.com/ggeop/Jarvis.git --branch develop

• 切换工作目录

cd Jarvis

• 设置贾维斯及系统依赖项：

bash setup.sh

• 将密钥放入设置文件

注意：为了获得更好的体验，您可以在启动应用之前将免费密钥放入settings.py文件中

nano Jarvis/src/jarvis/jarvis/setting.py

启动语音命令助手

• 启动助手服务：

bash run_jarvis.sh

如何为助手添加新技能

您可以轻松地通过两个步骤添加新技能。

• 在skills/registry.py中创建新的技能配置

{ 
  'enable': True,
  'func': Skills.new_skill,
  'tags': 'tag1, tag2',
  'description': '技能描述..'
}               

• 在skills/collection中创建新的技能模块

决策模型

技能提取

技能提取是通过为每个技能构建TF-IDF特征矩阵来实现的。 在下面的例子中，我们有一个包含三个技能的多维空间。 用户输入会在该空间中被分析，并通过相似度度量（如余弦相似度）找到最匹配的技能。

---

贡献

• 欢迎提交拉取请求（PR） :relaxed:
• 贡献流程如下：
  • 克隆项目
  • 切换到develop分支并创建功能分支，例如feature_branch
  • 向develop分支提交PR
  • 等待审核和批准！！
  • master分支的更新和发布会通过Travis CI/CD自动完成
• 尽量遵循PEP-8规范，并添加有用的注释！

CI/CD流程

🔗 相关项目

如果你喜欢这个虚拟助手，你可能也会对我的另一个基于人工智能的项目——DataDialogue 感兴趣。

通过自然对话，彻底改变你与数据库的交互方式！DataDialogue 让任何人都能做到：

• 💬 使用自然语言查询数据库
• 📊 即时获取数据可视化
• 🔍 无需掌握 SQL 即可探索数据
• 🤝 弥合数据团队与业务用户之间的鸿沟

Python-ai-assistant (Jarvis) 快速上手指南

Jarvis 是一款基于 Python 3.8 的智能语音助手，运行于 Linux 环境。它支持语音和文本交互，能够执行打开网页、播放音乐、查询天气、系统控制及自定义技能扩展等操作。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统: Ubuntu 20.04 (Focal Fossa) 或其他兼容的 Debian 系发行版。
• Python 版本: Python 3.8.x。
• 第三方 API 密钥: 为了使用天气、通用问答和定位功能，你需要免费注册并获取以下 API Key：
  • OpenWeatherMap (天气预报)
  • WolframAlpha (通用知识问答)
  • IPSTACK (当前位置定位)

安装步骤

1. 克隆项目代码

将仓库克隆到本地并进入项目目录：

git clone https://github.com/ggeop/Jarvis.git --branch master
cd Jarvis

贡献者注意：如果你计划参与开发贡献，请切换分支： git clone https://github.com/ggeop/Jarvis.git --branch develop

2. 安装系统依赖

运行提供的脚本自动安装所需的系统包和 Python 依赖：

bash setup.sh

3. 配置 API 密钥

为了获得最佳体验，请在启动前将申请的 API Key 填入配置文件。使用编辑器打开设置文件：

nano Jarvis/src/jarvis/jarvis/setting.py

在文件中找到对应位置，填入你从 OpenWeatherMap、WolframAlpha 和 IPSTACK 获取的 Key。保存并退出 (Ctrl+O, Enter, Ctrl+X)。

基本使用

启动助手

完成配置后，运行以下脚本启动 Jarvis 语音助手服务：

bash run_jarvis.sh

启动成功后，你将看到类似的控制台输出界面。此时助手已就绪，可以通过麦克风说话或直接在终端输入文本进行交互。

常用指令示例

你可以尝试以下指令来测试助手功能（默认唤醒词为 "Jarvis"）：

• 打开网页: Jarvis open youtube
• 播放音乐: Jarvis play mozart
• 调节音量: Jarvis volume up!
• 查询天气: Jarvis tell me the weather in London
• 查询时间: Jarvis tell me time or date
• 查看技能列表: Jarvis tell me your skills 或 Jarvis help
• 简单计算: Jarvis (5 + 6) * 8
• 开启学习模式: Jarvis remember (用于添加新的自定义回复)

扩展技能 (可选)

如需添加新技能，只需两步：

1. 在 skills/registry.py 中注册新技能配置。
2. 在 skills/collection 目录下创建对应的技能模块文件。