NeuralAgent(智能AI助手)简介
NeuralAgent是一个开源免费的智能AI助手,该工具不仅仅停留在简单的AI对话层面,而是真正能够在我们的桌面上执行实际操作的智能工具。这款软件可以在桌面上自动进行打字、点击、浏览器导航、表单填写、发送邮件等操作,使用主流的AI大语言模型实现全自动化任务处理。与传统的聊天式AI助手不同,该工具专注于提升真实的生产力,让AI真正成为我们工作和生活中的得力助手。

主要特色功能:
- 全面的桌面自动化能力:支持完整的桌面自动化功能,包括pyautogui集成,以及Windows平台上通过WSL实现的后台浏览器自动化。无论是简单的复制粘贴操作,还是复杂的多步骤工作流程,NeuralAgent都能够精准执行。
- 多模型支持与灵活配置:该工具支持多种主流AI模型,包括Claude、GPT-4、Azure OpenAI和Amazon Bedrock,用户可以根据不同的任务需求选择最适合的模型。这种灵活的配置方式确保了在各种场景下都能获得最佳的自动化效果。
- 模块化智能代理系统:采用模块化设计,包含规划器(Planner)、分类器(Classifier)、建议器(Suggestor)、标题生成器(Title)等多个专业化代理。每个代理都有其特定的功能,协同工作以完成复杂的自动化任务。
- 多模态交互体验:系统支持多模态输入,结合文本和视觉信息,能够更好地理解用户意图和屏幕内容,提供更精准的自动化操作。
NeuralAgent(智能AI助手)官网及教程
开源地址:https://github.com/withneural/neuralagent
安装相对简单,用户需要分别启动后端服务和桌面应用。系统支持本地PostgreSQL数据库配置,并可通过环境变量灵活配置各种AI模型的API密钥。
部署前准备
- Python 3.8+ 已安装
- Node.js 14.0+ 已安装
- PostgreSQL 已安装并运行
- 获得所需的AI API密钥(OpenAI/Anthropic等)
第一步:环境准备
1. 安装依赖软件
# 安装PostgreSQL
# Windows: 下载安装包从 https://www.postgresql.org/download/
# macOS: brew install postgresql
# Ubuntu: sudo apt-get install postgresql postgresql-contrib
# 安装Redis(可选)
# Windows: 下载安装包或使用WSL
# macOS: brew install redis
# Ubuntu: sudo apt-get install redis-server
# 安装Node.js
# 从 https://nodejs.org/ 下载对应系统版本
2. 克隆项目
git clone https://github.com/withneural/neuralagent.git
cd neuralagent
第二步:后端部署
1. 创建Python虚拟环境
cd backend
python -m venv venv
# 激活虚拟环境
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate
2. 安装Python依赖
pip install -r requirements.txt
3. 数据库配置
# 创建PostgreSQL数据库
psql -U postgres
CREATE DATABASE neuralagent;
CREATE USER neuralagent_user WITH PASSWORD 'your_password';
GRANT ALL PRIVILEGES ON DATABASE neuralagent TO neuralagent_user;
\q
4. 配置环境变量
# 复制环境变量模板
cp .env.example .env
# 编辑.env文件,填入以下配置:
# 数据库配置
DB_HOST=localhost
DB_PORT=5432
DB_DATABASE=neuralagent
DB_USERNAME=neuralagent_user
DB_PASSWORD=your_password
DB_CONNECTION_STRING=postgresql://neuralagent_user:your_password@localhost:5432/neuralagent
# JWT配置
JWT_ISS=NeuralAgentBackend
JWT_SECRET=your_jwt_secret_key
# Redis配置(可选)
REDIS_CONNECTION=redis://localhost:6379
# AI模型配置
OPENAI_API_KEY=your_openai_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key
# Azure OpenAI(可选)
AZURE_OPENAI_ENDPOINT=your_azure_endpoint
AZURE_OPENAI_API_KEY=your_azure_api_key
OPENAI_API_VERSION=2024-12-01-preview
# AWS Bedrock(可选)
AWS_ACCESS_KEY_ID=your_aws_access_key
AWS_SECRET_ACCESS_KEY=your_aws_secret_key
BEDROCK_REGION=us-west-2
# 各代理模型配置
CLASSIFIER_AGENT_MODEL_TYPE=anthropic
CLASSIFIER_AGENT_MODEL_ID=claude-3-haiku-20240307
TITLE_AGENT_MODEL_TYPE=openai
TITLE_AGENT_MODEL_ID=gpt-4-turbo-preview
SUGGESTOR_AGENT_MODEL_TYPE=anthropic
SUGGESTOR_AGENT_MODEL_ID=claude-3-sonnet-20240229
PLANNER_AGENT_MODEL_TYPE=anthropic
PLANNER_AGENT_MODEL_ID=claude-3-opus-20240229
COMPUTER_USE_AGENT_MODEL_TYPE=anthropic
COMPUTER_USE_AGENT_MODEL_ID=claude-3-5-sonnet-20241022
# Google登录(可选)
GOOGLE_LOGIN_CLIENT_ID=your_google_client_id
GOOGLE_LOGIN_CLIENT_SECRET=your_google_client_secret
GOOGLE_LOGIN_DESKTOP_REDIRECT_URI=http://127.0.0.1:36478
# LangChain追踪(可选)
LANGCHAIN_TRACING_V2=false
LANGCHAIN_ENDPOINT=
LANGCHAIN_API_KEY=
LANGCHAIN_PROJECT=
5. 运行数据库迁移
alembic upgrade head
6. 启动后端服务
uvicorn main:app --reload --host 0.0.0.0 --port 8000
第三步:前端部署
1. 安装Node.js依赖
# 在新终端窗口中
cd desktop
npm install
2. 配置React应用
cd neuralagent-app
cp .env.example .env
# 编辑.env文件:
REACT_APP_PROTOCOL=http
REACT_APP_WEBSOCKET_PROTOCOL=ws
REACT_APP_DNS=127.0.0.1:8000
REACT_APP_API_KEY=your_api_key
3. 启动桌面应用
cd .. # 回到desktop目录
npm start
第四步:验证部署
1. 检查服务状态
- 后端API: 访问
http://localhost:8000/docs
查看API文档 - 前端应用: Electron应用应该自动启动
- 数据库连接: 检查后端日志确认数据库连接成功
2. 功能测试
- 尝试登录/注册功能
- 测试简单的桌面自动化任务
- 验证AI模型调用是否正常
生产环境部署:使用Docker部署
# 创建docker-compose.yml文件
version: '3.8'
services:
postgres:
image: postgres:13
environment:
POSTGRES_DB: neuralagent
POSTGRES_USER: neuralagent_user
POSTGRES_PASSWORD: your_password
volumes:
- postgres_data:/var/lib/postgresql/data
ports:
- "5432:5432"
redis:
image: redis:alpine
ports:
- "6379:6379"
backend:
build: ./backend
ports:
- "8000:8000"
depends_on:
- postgres
- redis
environment:
- DB_CONNECTION_STRING=postgresql://neuralagent_user:your_password@postgres:5432/neuralagent
- REDIS_CONNECTION=redis://redis:6379
volumes:
postgres_data:
2. 反向代理配置(Nginx)
server {
listen 80;
server_name your-domain.com;
location / {
proxy_pass http://localhost:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /ws {
proxy_pass http://localhost:8000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
}
}
日志查看:
# 后端日志
tail -f backend/logs/app.log
# 前端日志
# 在Electron开发者工具中查看控制台
应用场景
- 办公自动化:对于需要处理大量重复性办公任务的用户,该工具可以自动完成数据录入、报表生成、邮件回复等工作,大幅提升工作效率。
- 开发辅助:程序员可以利用该工具来自动化代码部署、测试执行、文档生成等开发流程中的重复性任务。
- 个人效率提升:普通用户也可以使用该工具来自动化日常的电脑操作,如文件整理、应用启动、信息搜索等。