一、项目概述（💡NeuralAgent是什么？）

NeuralAgent 是一款开源的桌面 AI 助手，能够通过自然语言指令自动化执行多种复杂任务，如模拟键盘输入、鼠标点击、浏览器导航、表单填写和邮件发送等。它支持桌面自动化操作，并在 Windows 平台上实现后台浏览器控制，无需人工干预即可高效完成任务。（NeuralAgent 集成了多种主流语言模型（如 Claude、GPT-4、Azure OpenAI 等），并基于模块化设计，支持多模态（文本 + 视觉）交互，能够满足不同用户在办公自动化、网页自动化、个人生产力提升、创意工作辅助以及企业级应用等多场景下的需求。）

二、核心功能

（一）桌面自动化

NeuralAgent 可以通过模拟键盘输入、鼠标点击、表单填写、邮件发送和网页导航等操作，实现任务的自动执行。例如，用户可以通过简单的自然语言指令让 NeuralAgent 自动填写并发送邮件，或者自动完成网页表单的填写和提交，极大地提高了工作效率，减少了重复性劳动。

（二）后台任务执行

在Windows 平台上，NeuralAgent 支持后台浏览器控制，无需人工干预即可完成任务。这一功能使得用户可以在后台运行浏览器任务，同时继续进行其他工作，进一步提升了工作效率和便捷性。

（三）多语言模型支持

NeuralAgent 集成了多种主流语言模型，如 Claude 、GPT-4、Azure OpenAI、Bedrock、Ollama 和 Gemini 等。用户可以根据任务需求选择合适的语言模型，以获得最佳的执行效果。这种多语言模型支持不仅丰富了 NeuralAgent 的功能，还为用户提供了更多的选择和灵活性。

（四）跨平台运行

NeuralAgent 支持 Windows、macOS 和 Linux 三大主流操作系统，具有良好的跨平台兼容性。虽然部分功能（如后台自动化）目前仅限 Windows，但其跨平台设计使得用户可以在不同操作系统上使用 NeuralAgent，满足不同用户的需求。

三、技术揭秘

（一）架构设计

NeuralAgent 采用了分层架构设计，主要包括 FastAPI 后端、Electron 桌面应用以及 React 前端。FastAPI 后端负责处理 API 请求和任务调度，并集成 PostgreSQL 数据库用于存储任务数据和用户信息；Electron 桌面应用提供跨平台的用户界面，内嵌 React 前端框架以实现流畅的用户体验；Python 自动化脚本则基于 pyautogui 库实现桌面自动化操作，如鼠标点击和键盘输入，并在 Windows 平台上通过 WSL（Windows Subsystem for Linux）实现后台浏览器控制。

（二）模块化代理系统

NeuralAgent 基于模块化设计，将不同任务分配给专门的代理模块，如规划器、分类器、建议器等。每个模块根据任务需求调用不同的语言模型，实现智能分析和执行。这种模块化设计不仅提高了系统的灵活性和可扩展性，还使得用户可以根据实际需求灵活配置各个模块的功能，以满足多样化的任务场景。

（三）多模态交互

NeuralAgent 支持多模态交互，能够处理文本和视觉输入，结合图像和文字信息完成任务。这种多模态交互能力使得  NeuralAgent 在处理复杂的任务时更具优势，例如在创意工作辅助场景中，用户可以通过上传设计草图并结合文本描述，让 NeuralAgent 生成更贴合需求的创意文案或代码片段。

四、应用场景

（一）办公自动化

在办公场景中，NeuralAgent 可以自动填写和发送邮件、编辑文档、生成报告等，显著提升工作效率，减少重复性劳动。例如，用户可以通过自然语言指令让 NeuralAgent 自动整理会议记录并生成报告，或者自动填写报销单并发送给相关人员审批，让办公更加高效便捷。

（二）网页自动化

NeuralAgent 能够快速抓取网页数据、自动提交表单、批量处理网页任务，助力用户高效收集信息和完成在线操作。例如，用户可以通过 NeuralAgent 自动抓取新闻网站的最新资讯，或者自动提交在线问卷调查，大大提高了网页操作的效率和便捷性。

（三）个人生产力提升

NeuralAgent 可以智能规划日常任务、整理信息、生成笔记，帮助用户高效管理时间和工作，提升个人生产力。例如，用户可以通过自然语言指令让 NeuralAgent 根据自己的日程安排生成待办事项清单，或者自动整理学习资料并生成笔记，更好地管理个人事务。

（四）创意工作辅助

NeuralAgent 能够生成创意文案、辅助设计草图、提供代码片段，激发创作灵感，加速创意工作流程，助力创意实现。例如，设计师可以通过 NeuralAgent 生成设计灵感文案，程序员可以通过 NeuralAgent 获取代码片段，从而提高创意工作的效率和质量。

（五）企业级应用

在企业级应用中，NeuralAgent 可以自动分析数据、跟踪项目进度、生成项目报告，助力企业高效运营与管理，提升团队协作效率。例如，企业可以通过 NeuralAgent 自动分析销售数据并生成销售报告，或者自动跟踪项目进度并生成项目进度报告，帮助企业更好地进行决策和管理。

五、快速使用

（一）环境准备

在开始部署NeuralAgent 之前，需要确保以下依赖已安装在机器上：

1. Python：用于后端和本地 AI 代理守护进程，推荐版本 >= 3.9。

2. PostgreSQL：后端使用的数据库，推荐版本 >= 13。

3. Node.js + npm：用于运行  Electron + React 前端，推荐版本 Node >= 18，npm >= 9。

（二）后端设置

1. 创建并激活虚拟环境（可选但推荐）：

cd backendpython -m venv venv# 激活：source venv/bin/activate # macOS/Linuxvenv\Scripts\activate # Windows

2. 安装依赖：

pip install -r requirements.txt

3. 创建本地 Postgres 数据库（需要在计算机上安装 Postgres）。

4. 复制 `.env.example` 到 `.env` 并填写相关信息，包括数据库连接信息、JWT 配置、模型提供商 API 密钥等。

5. 运行数据库迁移：

alembic upgrade head

6. 启动后端服务器：

uvicorn main:app --reload --host 0.0.0.0 --port 8000

（三）前端（桌面+ Electron）设置

1. 安装 Electron 依赖：

npm install

2. 进入 React 应用目录：

cd neuralagent-appnpm install

3. 复制 `.env.example` 到 `.env` 并填写相关信息，包括协议、DNS、API  密钥等。

4. 返回桌面根目录。

5. 设置本地 AI 代理守护进程（Python 服务）：

cd aiagentpython -m venv venvsource venv/bin/activate # 或在 Windows 上使用 `venv\Scripts\activate`pip install -r requirements.txtdeactivate

6. 启动 Electron 桌面应用：

npm run electron:serve

（四）使用说明

1. 启动后端和前端服务：按照上述步骤启动后端和前端服务后，打开浏览器访问 `http://127.0.0.1:8000`，即可进入 NeuralAgent 的 Web 界面。

2. 配置模型提供商：在 `.env` 文件中配置所需的模型提供商（如 OpenAI、Azure OpenAI 等），并根据需求选择合适的模型。

3. 输入自然语言指令：在 NeuralAgent 的界面中输入自然语言指令，例如“自动填写并发送邮件”，NeuralAgent 将自动执行相应的任务。

4. 查看任务执行结果：任务执行完成后，可以在界面上查看执行结果，或者通过日志文件查看详细信息。

六、结语

NeuralAgent 作为一款开源的桌面 AI 助手，凭借其强大的自然语言处理能力、多模态交互功能以及模块化设计，为用户带来了高效、便捷的自动化体验。无论是在办公自动化、网页自动化、个人生产力提升、创意工作辅助还是企业级应用等场景中，NeuralAgent 都能够满足用户多样化的需求。

项目官网：https://www.getneuralagent.com/

GitHub 仓库： https://github.com/withneural/neuralagent

点亮“关注”，设为“星标”，精彩不迷路！与你携手探索AI的无限可能，精彩内容持续更新！🚀