NexAgent - AI 对话框架,支持多服务商、多模型切换、深度思考、工具调用、流式输出、多会话管理
Project description
NexAgent
AI 对话框架,支持多模型、多会话、工具调用、MCP 协议、深度思考、记忆功能、角色卡。
特性
- 🔄 多模型切换 - 支持 OpenAI、DeepSeek 等兼容 API
- 💬 多会话管理 - 独立上下文,消息编辑/重新生成
- 🎭 角色卡 - 自定义 AI 人设和参数
- 🧠 记忆功能 - 基于向量的长期记忆
- 🔧 工具调用 - 内置 + 自定义 + MCP 工具
- 💭 深度思考 - 展示 AI 推理过程
- 📡 流式输出 - 实时返回内容
- 🌐 WebUI - 现代化界面,深色/浅色主题
快速开始
pip install nex-agent
nex init # 初始化工作目录
nex serve # 启动服务 (默认 8000 端口)
打开 http://localhost:8000,在设置中添加服务商和模型即可使用。
代码使用
from nex_agent import NexFramework
nex = NexFramework("./my_project")
# 创建会话并对话
session_id = nex.create_session("测试", "user1")
reply = nex.chat("user1", "你好", session_id=session_id)
# 流式对话
for chunk in nex.chat_stream("user1", "讲个故事", session_id=session_id):
print(chunk, end="", flush=True)
自定义工具
在 tools/ 目录创建 Python 文件:
# tools/calculator.py
TOOL_DEF = {
"name": "calculator",
"description": "计算器",
"parameters": {
"type": "object",
"properties": {"expression": {"type": "string"}},
"required": ["expression"]
}
}
def execute(args):
return str(eval(args["expression"]))
API
主要接口:
| 接口 | 说明 |
|---|---|
POST /nex/chat |
对话(支持流式) |
GET/POST/DELETE /nex/sessions |
会话管理 |
GET/POST/DELETE /nex/models |
模型管理 |
GET/POST/DELETE /nex/providers |
服务商管理 |
GET/POST/DELETE /nex/personas |
角色卡管理 |
GET/POST/DELETE /nex/memories |
记忆管理 |
GET/POST/DELETE /nex/mcp/servers |
MCP 服务器 |
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
nex_agent-0.4.5.tar.gz
(91.0 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
nex_agent-0.4.5-py3-none-any.whl
(94.2 kB
view details)
File details
Details for the file nex_agent-0.4.5.tar.gz.
File metadata
- Download URL: nex_agent-0.4.5.tar.gz
- Upload date:
- Size: 91.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
de0a418a76ad93341d5ea9e7219a2ba6d12e3544beb556155130ffa95e1f4297
|
|
| MD5 |
1505a76515dcebcd0605e068b62ee128
|
|
| BLAKE2b-256 |
ca3a8f9ab485d87be7676480370cfe2186e36e42eb88050f68a23dde5e608e7a
|
File details
Details for the file nex_agent-0.4.5-py3-none-any.whl.
File metadata
- Download URL: nex_agent-0.4.5-py3-none-any.whl
- Upload date:
- Size: 94.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6468fca5a39a1b4964897ab7587c06326d1c08e289123268a9d23da52baf74e9
|
|
| MD5 |
66f7780d93ae22f07a182a2a126b8d19
|
|
| BLAKE2b-256 |
edf5e70b356ff209adad200569747d26b9b4467705bd1f8d86465a76d087a983
|