Hello，大家好！今天为大家介绍 kunavatar 的基础使用方法。这是一款基于 Ollama 本地推理引擎的 AI 对话桌面客户端，依托本地部署的特性确保数据全程私密可控，旨在让 AI 成为你的专属分身与数字伙伴。

一、如何获取

1. 源码部署

1.1 进入GitHub仓库，搜索KunLabAI/KunAvatar，clone项目至本地

git clone <https://github.com/KunLabAI/kun-avatar.git>
cd kun-avatar

1.2 安装依赖

npm run install

1.3 构建项目

npm run build

1.4 启动应用

npx start

2. 客户端下载

2.1 进入GitHub仓库，搜索KunLabAI/KunAvatar，找到releases，下载最新版本（目前只支持Windows版本）

2.2 点击链接直接下载：

https://github.com/KunLabAI/KunAvatar/releases/download/v0.0.3/KunAvatar_Setup_0.0.3.exe

2.3 下载完之后安装即可。

二、如何使用

1. 账号获取

首次运行，系统会检测数据库，如果为空，点击注册新账号按钮。

完成注册既可获取超级管理员账号。

2. 开始使用

2.1 推理引擎检测

登陆后系统会自动检测推理引擎，如果系统检测出您未启动推理引擎，则会提醒你去安装或者启动ollama（目前只支持ollama，后续会依次支持LMstudio和vllm）。

2.2 拉取模型

如果您已启动 Ollama 但尚未获取模型，可按以下步骤操作：

  • 跳转至模型管理页面，点击 “拉取” 按钮，此时会弹出拉取模型的弹窗；
  • 在弹窗底部的操作区域，点击 “Ollama” 或 “Model Scope” 快捷按钮，即可进入对应的模型库；
  • 在模型库中找到您需要的模型后，输入命令 “ollama run {模型名称}”，即可完成该模型的拉取。

3. MCP服务器与工具配置

为减少学习成本，我们特地简化 MCP 服务器的使用流程，已精简操作步骤：本地命令行安装环节已全部舍去（看以后我们用户的需求）。所有MCP服务器的安装都交由托管平台自动处理，您只需获取托管平台生成的 API URL，即可轻松完成配置。

3.1 本地MCP服务器

在MCP服务器管理页总共有两大类，本地和外部，本地服务器我们已经集成了一些工具（时间获取，文件操作（读取、写入等），计算器等基础工具），直接使用即可。

3.2 外部MCP服务器

点击添加服务器按钮，弹出添加MCP服务器弹窗，在连接配置板块选择服务器类型。下面以魔搭社区的MCP托管平台为演示示例：

进入魔搭社区MCP广场页面后，找到服务器类型为“Hosted”标签，点击后会筛选出所有能运行在魔搭托管平台的MCP服务，我们随便挑一个：ModelScope-Image-Generation-MCP（这个工具是文生图工具，使用的是black-forest-labs/FLUX.1-Kontext-dev）

这里需要填入用户的访问令牌，可以按照以下步骤执行。

获取到访问令牌之后，复制到刚才的APIkey输入框，即可获取到JSON格式。

单独复制出url：https://mcp.api-inference.modelscope.net/34de92f7e9654c/sse

让我们返回kunavatar，把复制到的url粘贴到kunavatar服务器url输入框内，点击连接，便可获取到MCP工具，然后输入服务器名称点击添加服务器按钮完成创建。

工具列表可以在服务器卡片中点击查看或者手动测试。

4. MCP服务器工具使用

让我们返回到聊天对话模块，在用户输入组件中打开MCP服务器工具列表，选中工具（如果不知道想要模型使用哪个工具可以全选，让模型决定使用哪个工具）。

如果不知道这些工具分别有什么用，可以直接问AI模型。本质上是用户消息和工具列表一同发送给AI模型，工具列表包含工具名称、描述、特有字段等参数，所以上下文token数量巨大，小模型几轮对话就会产生幻觉了。

另外，还有个小功能，优化提示词专用，如果您不知道怎么编写提示词，可以输入一句简单的，让辅助模型帮您优化。

生成的图片效果很一般哈哈，原因就是调用的这个MusePublic/489_ckpt_FLUX_1默认文生图模型。

写在最后

好了，以上就是KunAvatar的基本使用流程，还有更多功能等待您的探索，如果有使用上的问题请联系我，24小时在线等您留言！如果您喜欢这个项目，可以在GitHub上点个小星星。感谢！

项目地址：

https://github.com/KunLabAI/KunAvatar

客户端下载地址：

https://github.com/KunLabAI/KunAvatar/releases/download/v0.0.3/KunAvatar_Setup_0.0.3.exe

返回