OmniSteward：基于 LLM Agent 的智能家居与电脑控制工具

1. 克隆仓库： 打开命令行终端（如 CMD 或 PowerShell），输入以下命令克隆 OmniSteward 项目仓库到本地：

git clone https://github.com/OmniSteward/OmniSteward.git

克隆完成后，使用 cd 命令进入项目目录：

cd OmniSteward

2. 安装依赖： 在项目目录中，执行以下命令安装项目所需的依赖项：

pip install -r requirements.txt

3、环境变量配置

1. 打开项目中的 examples/env.cmd 文件，您需要在该文件中配置一系列环境变量，具体如下：

OPENAI_API_BASE=your_api_base # OpenAI 格式 API 基础 URL
OPENAI_API_KEY=your_api_key # OpenAI 格式 API 密钥
SILICON_FLOW_API_KEY=your_api_key # Silicon Flow API 密钥，用于 ASR, ReRank
BEMFA_UID=your_bemfa_uid # 巴法云平台 UID（可选）
BEMFA_TOPIC=your_bemfa_topic # 巴法云平台 Topic（可选）
KIMI_PROFILE_PATH=path_to_chrome_profile # Chrome 用户数据目录（可选）
LOCATION=your_location # 你的地理位置（可选）
LLM_MODEL=your_llm_model # 使用的 LLM 模型，默认使用 Qwen2.5-7B-Instruct

备注：获取 OPENAI 格式的 API 密钥和 API 基础 URL 参见大语言模型平台： https://github.com/OmniSteward/OmniSteward/blob/main/docs/PLATFORM.md

4、启动方式

OmniSteward 支持两种使用方式，即命令行模式（CLI）和 Web 模式。

4.1 命令行模式（CLI）

1. 环境变量配置（重要）： 在启动命令行模式之前，请务必先在 examples/env.cmd 文件中按照上述要求正确配置环境变量。
2. 麦克风语音输入模式： 首先，启动 VAD（语音活动检测）服务，在命令行中输入：

python -m servers.vad_rpc

启动 VAD 服务后，新开一个命令行窗口，执行以下命令使环境变量生效并运行 CLI：

call examples\env.cmd python -m core.cli --config configs/cli.py

3. 文字输入模式： 若您希望使用文字输入方式与 OmniSteward 交互，在配置好环境变量后，在命令行中输入：

call examples\env.cmd python -m core.cli --query"打开网易云音乐"--config configs/cli.py

4. 简单添加自定义工具： 如果您想要添加自定义工具，可在命令行中使用类似的方式调用，例如：

call examples\env.cmd python -m core.cli --query"打印 你好"--config configs/cli_custom_tool.py

4.2 Web 模式

1. 环境变量配置（重要）： 在使用 Web 模式之前，要先在 examples/env.cmd 文件中正确配置环境变量，尤其是 Silicon Flow API 密钥。
2. 启动后端服务： 在项目根目录下，执行以下命令配置环境变量并启动后端服务：

call examples\env.cmd python -m servers.steward --config configs/backend.py

3. 启动前端服务： 前端服务的启动请详见 OmniSteward - Frontend 项目的相关说明。
4. 使用： 完成后端和前端服务的启动后，使用 Chrome/Edge 浏览器，打开 http://localhost:8000，即可开始使用 OmniSteward。 如果您需要在外网使用，由于 Chrome/Edge 默认禁止 HTTP 下的麦克风，您需要进行额外的设置。具体操作是，在浏览器地址栏中输入 chrome://flags/#unsafely-treat-insecure-origin-as-secure，将其值设置为 http://ip:port（其中 ip 为您的服务器 IP 地址，port 为端口号）。手机上使用时，同样可以使用 Chrome 或者 Edge 浏览器，打开 http://ip:port，并按照上述方法进行设置后即可开始使用。

应用场景与未来展望

1. 家庭生活场景： 在家庭生活中，OmniSteward 成为智能家居的控制中心。早晨，用户可通过语音指令让其打开窗帘、播放音乐；晚上，可控制灯光关闭、设置闹钟等。还可用于家庭账单查询、日程安排等。

2. 办公学习场景： 在办公场景下，帮助用户快速启动办公软件、查找资料、管理文件，如'打开 PPT 并切换到演示模式''查找项目相关文档'等指令，有效提高办公效率。对于学生学习，可作为智能学习伙伴，解答学习问题、推荐学习资源。

3. 未来发展趋势： 随着技术的不断进步，OmniSteward 将在更多领域发挥重要作用。在智能家居方面，与更多设备深度集成；在智能健康领域，与健康监测设备结合提供健康建议；在智能交通领域，与车辆系统对接实现语音控制和交通信息查询。

结语

OmniSteward 作为一款充满潜力的全能 AI 管家系统，以其丰富的功能、先进的技术架构和广阔的应用前景，为我们展示了智能生活的美好画卷。尽管目前仍处于积极开发阶段，但它已经迈出了坚实的步伐。在未来，随着技术的持续创新和应用场景的不断拓展，OmniSteward 有望成为智能生活领域的核心应用。

项目地址：https://github.com/OmniSteward/OmniSteward