Nexent开发环境搭建

最近在尝试本地搭建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 sdk pip 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 frontend npm install npm run dev

Failed to load SWC binary for win32/64

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

相关推荐
寻道码路1 小时前
大模型工程化实战(一):概率坍塌的救赎 - 给LLM输出加锁
大模型·agent·langgraph·ai工程化·llm确定性
MomentYY2 小时前
RAG 图检索&多跳推理:有些答案需要“顺藤摸瓜”
人工智能·agent·ai编程
maynormoe2 小时前
从 Vibe Coding 到 Verified Coding:让 Agent 真正进入编码生产的最佳实践
agent·vibecoding
bonibabi2 小时前
基于 CopilotKit + Java SSE 构建 AI Agent 的前端实践指南
前端·agent
沐言人生3 小时前
HelloAgentR工程手记1/100天——项目工作流搭建
spring boot·agent·vibecoding
Erishen3 小时前
💡 比“怎么做”更值钱的是“为什么不那么做”:ai-analyze 的五个设计决策
开源·agent·mcp
用户469368483203 小时前
kimi-code 深度掌握系列文章-会话记录的数据层:Transcript (十三)
agent
hust_wangyajun3 小时前
我用 Agent Reach 生成了 Claude Code 年度生态报告:一篇实战演练
ai·agent·claude code
凡泰AI4 小时前
金融机构如何选择自己的企业级 AI桌面终端?
人工智能·agent·企业级ai·企业级agent