最近在尝试本地搭建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...](https://link.juejin.cn?target=https%3A%2F%2Fmirrors.tuna.tsinghua.edu.cn%2Fpypi%2Fweb%2Fsimple "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple") 打开cmd,输入命令:pip install uv 安装uv #### 修改uv下载源: 安装uv完成后,打开%AppData%\\uv (如果不存在自己新建文件夹即可)  新建文件 uv.toml,输入如下配置切换至清华源(如果还是有网络问题可以尝试切换阿里,南京大学,豆瓣等镜像,总有能用的): python-install-mirror = "[pypi.tuna.tsinghua.edu.cn/simple/](https://link.juejin.cn?target=https%3A%2F%2Fpypi.tuna.tsinghua.edu.cn%2Fsimple%2F "https://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 sdk pip install . #### 环境变量缺失: 所有依赖包下载完成后运行mcp server就没有问题了。运行其他两个服务可能会遇到环境变量缺失的问题,可尝试将docker中的环境变量复制到启动路径下的 .env文件中。 这个问题预计下周会优化,在此也不展开了。   ### node #### 版本: node我个人建议使用nvm管理,可以参考此文档下载备份(官方地址可能存在网络问题): [blog.csdn.net/zgphacker20...](https://link.juejin.cn?target=https%3A%2F%2Fblog.csdn.net%2Fzgphacker2010%2Farticle%2Fdetails%2F139558876 "https://blog.csdn.net/zgphacker2010/article/details/139558876") 我用的是22.16.0  #### 指定npm镜像源: 打开cmd执行命令,选用淘宝的npm镜像: npm config set registry [registry.npmmirror.com](https://link.juejin.cn?target=https%3A%2F%2Fregistry.npmmirror.com "https://registry.npmmirror.com") 进入front工程目录执行命令: cd frontend npm install npm run dev #### Failed to load SWC binary for win32/64 npm run dev 时如果遇到此问题,可参考此文档解决:[cloud.tencent.com/developer/a...](https://link.juejin.cn?target=https%3A%2F%2Fcloud.tencent.com%2Fdeveloper%2Farticle%2F2428871 "https://cloud.tencent.com/developer/article/2428871") 