掘金 人工智能 07月28日
Nexent开发环境搭建
index_new5.html
../../../zaker_core/zaker_tpl_static/wap/tpl_guoji1.html

 

本文详细介绍了在本地搭建Nexent开发环境的步骤和注意事项。文章强调了Python和Node.js环境的配置,包括Python版本选择(建议3.10.x)、环境变量设置、pip下载源修改(推荐清华源)、uv工具安装及配置。同时,也涵盖了Node.js版本管理(推荐使用nvm)、npm镜像源设置(淘宝镜像)以及解决npm run dev时可能出现的SWC二进制文件加载问题。文中还提供了解决依赖缺失和环境变量缺失的实用建议,旨在帮助开发者高效地完成Nexent开发环境的部署。

🐍 **Python环境配置**:建议使用Python 3.10.x版本,避免过高版本可能带来的包兼容性问题。需正确配置Python环境变量,并将pip下载源切换至国内镜像(如清华源)以解决网络下载缓慢或失败的问题。安装`uv`工具并配置其下载源,用于加速依赖安装。

📦 **后端依赖安装与服务启动**:在安装完所有Python依赖后,按顺序启动数据处理服务、主服务和MCP服务。若遇到“No module named 'xxx'”的错误,通常是缺少特定Python包,可通过`pip install 'xxx'`自行安装。若缺少`nexent`相关包,需切换到`sdk`目录执行`pip install .`进行安装。

💡 **Node.js与前端开发**:推荐使用nvm管理Node.js版本(如22.16.0),并设置npm镜像源为淘宝镜像以提高下载速度。在前端项目目录下执行`npm install`安装依赖,并通过`npm run dev`启动开发服务器。若遇到“Failed to load SWC binary”问题,需参考相关文档进行解决。

⚠️ **环境变量与服务运行**:在所有依赖安装完毕后,若运行MCP server仍有问题,可能与环境变量缺失有关。建议将Docker环境中的环境变量复制到启动路径下的`.env`文件中。其他服务也可能遇到环境变量问题,需根据实际情况处理。

最近在尝试本地搭建nexent环境,也是遇到了非常多的问题,总结一下方便大家自己搭建开发环境:

开发指南简述命令:

开发环境搭建:

开发主要依赖python和nodejs。

python:

版本:

项目使用的 Python版本为: 3.10.x

python官方下载地址:www.python.org/downloads/w…

我之前使用了3.13版本过高可能会报这种找不到配套包的错误。

python 环境变量配置:

打开环境变量-Path-添加python配置:

修改pip下载源:

由于国内网络受限,从官方源下载可能存在网络问题,一般将下载源切换为国内的镜像。打开%AppData%\pip (如果不存在自己新建文件夹即可)

新建pip.ini文件,输入如下配置切换至清华源(如果还是有网络问题可以尝试切换阿里,南京大学,豆瓣等镜像,总有能用的):

[global]index-url = mirrors.tuna.tsinghua.edu.cn/pypi/web/si…

打开cmd,输入命令:pip install uv安装uv

修改uv下载源:

安装uv完成后,打开%AppData%\uv (如果不存在自己新建文件夹即可)

新建文件 uv.toml,输入如下配置切换至清华源(如果还是有网络问题可以尝试切换阿里,南京大学,豆瓣等镜像,总有能用的):

python-install-mirror = "pypi.tuna.tsinghua.edu.cn/simple/"

输入命令:uv sync && uv pip install -e ../sdk 下载后端依赖

下载其他依赖

按文档依次执行如下命令运行后端服务,此时会报缺少一些依赖的错误:形如:No module named 'xxx'如果缺少的是常见的工具包,可自行使用pip下载缺少的包pip install 'xxx'

python backend/data_process_service.py # 数据处理服务python backend/main_service.py # 主服务python backend/nexent_mcp_service.py # MCP 服务

下载sdk依赖

缺少nexent的包时会报这个异常:

此时可切换到sdk目录执行pip install命令:

cd sdkpip install .

环境变量缺失:

所有依赖包下载完成后运行mcp server就没有问题了。运行其他两个服务可能会遇到环境变量缺失的问题,可尝试将docker中的环境变量复制到启动路径下的 .env文件中。

这个问题预计下周会优化,在此也不展开了。

node

版本:

node我个人建议使用nvm管理,可以参考此文档下载备份(官方地址可能存在网络问题):

blog.csdn.net/zgphacker20…

我用的是22.16.0

指定npm镜像源:

打开cmd执行命令,选用淘宝的npm镜像:npm config set registry registry.npmmirror.com

进入front工程目录执行命令:cd frontendnpm installnpm run dev

Failed to load SWC binary for win32/64

npm run dev 时如果遇到此问题,可参考此文档解决:cloud.tencent.com/developer/a…

Fish AI Reader

Fish AI Reader

AI辅助创作,多种专业模板,深度分析,高质量内容生成。从观点提取到深度思考,FishAI为您提供全方位的创作支持。新版本引入自定义参数,让您的创作更加个性化和精准。

FishAI

FishAI

鱼阅,AI 时代的下一个智能信息助手,助你摆脱信息焦虑

联系邮箱 441953276@qq.com

相关标签

Nexent 开发环境 Python Node.js 环境搭建
相关文章