Dulus：开源轻量化AI代理框架，免密钥调用多模型且内置全场景工具集

一、什么是 Dulus

Dulus 前身为 Kilocode、Falcon，是由开发者 KevRojo 主导开发的开源轻量级Python AI自主代理框架，项目托管于GitHub平台，基于Python语言构建，代码体量精简、部署门槛极低。该项目核心定位为免密钥、免登录、全平台可用的一站式AI代理工具，打破传统大模型调用需要API密钥、付费订阅、绑定信用卡的限制，通过抓取主流AI网页会话、对接云端大模型与本地部署模型双重链路，实现大模型自由调用。

项目命名源自多米尼加国鸟Dulus，整体遵循 GPLv3 开源协议，核心CLI功能永久免费开放，同时配套插件系统、多代理协作、内置工具集、语音交互、沙盒运行等进阶能力，兼顾个人日常使用、开发者工程落地、团队自动化协作等多元需求。项目早期代号Kilocode，后续正式更名Dulus，社区持续迭代优化模型适配、工具扩展与运行稳定性，是当下轻量化AI代理领域极具实用性的开源项目。

二、功能特色

Dulus 整合了模型调用、智能工具、代理协作、交互体验、安全运行五大模块，功能覆盖基础对话到高阶自动化任务，核心特色如下：

2.1 零成本模型调用，彻底免除密钥限制

• 免API密钥：无需申请各类大模型官方密钥、无需付费订阅、无需绑定支付账户，默认直连主流免费云端大模型，开箱即用。

• 海量模型兼容：原生支持 Gemini、Claude、Kimi、通义千问、DeepSeek 等国内外主流云端模型，同时兼容 LiteLLM 生态下100+商用模型。

• 本地模型适配：无缝对接 Ollama、LM Studio 等本地大模型部署工具，支持离线环境运行，保护数据隐私。

• 免费算力补充：内置NVIDIA NIM 14款免费模型，搭载自动限流、故障降级机制，保障服务持续可用。

2.2 27+内置工具集，一站式完成复杂任务

框架原生集成27类实用工具，覆盖办公、开发、网络、图像处理全场景，无需额外安装第三方软件：

• 文件操作：本地文件读写、格式转换、目录管理；

• 运维开发：Bash命令执行、代码编写、代码调试、项目评审；

• 网络能力：网页搜索、网页内容抓取、网络请求；

• 视觉处理：OCR文字识别，快速提取图片、截图内文字；

• 记忆管理：持久化语义记忆模块，区分用户记忆与项目专属记忆；

• 任务管理：多任务拆分、子任务调度、会话快照保存。

2.3 智能多代理协作体系

• 子代理分工：支持创建编码代理、测试代理、文档代理、评审代理等专项子代理，多代理并行协作，各司其职处理复杂流程。

• 圆桌辩论模式：开启多模型辩论功能，调用不同大模型针对同一问题交叉论证，提升答案全面性与准确性。

• 插件自动适配（Auto-Adapter）：独创Auto-Adapter机制，可自动适配任意Python开源仓库，无需手动编写配置文件，插件接入零门槛。

• MCP标准集成：兼容行业通用MCP服务标准，外部工具可自动注册至框架内，扩展性拉满。

2.4 多元化交互与体验优化

• 离线语音交互：集成Whisper语音模型，支持离线语音输入、语音转文字，多语言语音识别无障碍。

• 多语言全局切换：内置/lang指令，支持34种主流语言一键切换界面与对话语言，同时可自定义AI角色、语气、人设。

• 上下文优化：自动压缩超长会话上下文，避免对话冗余导致响应变慢，兼顾对话完整性与运行效率。

• 跨平台联动：支持Telegram桥接功能，可将AI代理部署至电报群组，实现社群自动化问答、消息处理。

2.5 安全隔离运行环境

• 内置轻量沙盒系统：所有命令、代码、脚本均在独立沙盒中执行，隔离风险，避免恶意代码、异常指令影响本地设备系统。

• 会话隔离：不同用户、不同项目会话相互独立，记忆数据互不干扰。

2.6 极速部署，全平台兼容

项目无编译流程，纯Python代码实现，Windows、Linux、macOS三大主流操作系统全面适配，支持脚本一键部署、Docker容器部署、源码部署三种方式，最快30秒即可完成部署并投入使用。

三、技术细节

3.1 整体技术架构

Dulus 采用分层模块化架构，整体分为接入层、调度层、能力层、底层依赖层四层，模块解耦清晰，便于二次开发与功能拓展：

1. 接入层：负责模型来源对接，分为网页会话抓取模块、标准API对接模块、本地模型对接模块，实现云端/本地模型统一入口；

2. 调度层：核心中枢，包含代理调度、任务分发、限流降级、负载均衡四大子模块，管控多代理、多模型协同逻辑；

3. 能力层：整合内置工具集、插件系统、记忆系统、沙盒环境、语音模块、多语言模块，对外输出完整功能；

4. 底层依赖层：基于Python生态，依赖网络请求库、Whisper语音库、OCR库、LiteLLM模型适配库、MCP协议库等主流开源组件。

3.2 核心技术亮点

1. 网页会话抓取技术
   项目核心创新技术之一，通过模拟正常浏览器访客会话，抓取主流AI平台公开会话通道，绕过官方API鉴权体系，实现免密钥调用。该技术仅使用平台公开访客接口，不破解、不篡改官方服务，合规性有保障，同时定时维护会话链路，保障稳定性。

2. MemPalace语义记忆系统
   自研持久化语义记忆组件MemPalace，区别于传统短期上下文记忆，可长期存储对话内容、用户习惯、项目信息，并通过语义检索匹配历史内容，实现跨会话连贯对话。记忆分为个人记忆和项目记忆两类，分类存储便于管理。

3. Auto-Adapter自动插件适配
   基于Python反射机制与项目结构识别算法，自动解析第三方Python项目目录、入口文件、函数接口，无需手动编写配置文件即可完成插件接入，大幅降低二次开发与扩展难度。

4. 沙盒运行机制
   采用进程级隔离沙盒，对Bash命令、Python代码、外部脚本做权限限制、资源限制，禁止高危系统指令执行，从技术层面规避安全风险，兼顾实用性与安全性。

5. 上下文动态压缩算法
   针对超长对话场景，采用语义摘要+冗余过滤结合的算法，优先保留核心对话逻辑，剔除重复、无效内容，在不丢失关键信息的前提下缩减上下文长度，提升模型响应速度。

3.3 开发与运行环境要求

• 基础运行环境：Python 3.8 及以上版本；

• 网络环境：联网状态可使用云端大模型，离线环境仅支持Ollama等本地模型；

• 硬件要求：普通个人电脑、低配服务器均可运行，无高端硬件门槛；

• 协议规范：主程序采用 GPLv3 开源协议，二次分发、二次开发需遵守对应开源规则。

3.4 代码与项目结构

项目整体代码量约1.2万行纯可读Python代码，无闭源二进制文件，目录划分清晰：

Dulus/
├── core/     # 框架核心调度、代理管理、任务分发模块
├── models/    # 各大模型对接、会话抓取、API适配代码
├── tools/     # 27+内置工具集代码
├── memory/    # MemPalace语义记忆系统
├── sandbox/    # 沙盒运行环境代码
├── voice/     # Whisper语音交互模块
├── plugins/    # 插件系统与Auto-Adapter核心逻辑
├── lang/     # 多语言翻译、语言切换配置
└── cli.py     # 命令行入口主程序

四、应用场景

Dulus 凭借轻量化、多功能、免密钥的特性，适配个人用户、开发者、小型团队三大群体，覆盖日常、办公、开发、自动化多类场景：

1. 个人日常使用
   普通用户无需注册各大AI平台账号、无需付费，通过Dulus一键调用主流大模型，用于日常问答、文案创作、知识学习、生活建议；离线语音功能可实现语音对话，解放双手。

2. 开发者编程与运维
   程序员可利用内置代码工具、Bash工具、OCR工具，在终端内完成代码编写、BUG调试、项目文档生成、服务器运维、日志分析；子代理分工模式可实现编码、测试、评审一体化流程，提升开发效率。

3. 办公自动化场景
   依托文件工具、网页抓取、搜索工具，完成资料搜集、文档整理、文字识别、内容总结等办公工作，替代多款零散工具。

4. 团队社群协作
   借助Telegram桥接功能，将AI代理部署至社群，实现自动答疑、消息汇总、任务提醒，打造社群智能助手。

5. 离线隐私办公
   对接Ollama本地大模型，全程断网运行，所有数据留存本地，适合政企、涉密场景下的AI使用需求，杜绝数据外泄风险。

6. 二次开发与项目教学
   纯开源Python代码、模块化架构，适合AI爱好者、编程学习者学习AI代理开发逻辑；开发者可基于本框架二次定制专属AI工具、行业智能代理。

五、使用方法

Dulus 提供三种主流部署使用方式，覆盖新手、服务器运维、容器化部署不同需求，操作简单易懂。

5.1 前置准备

确保设备已安装 Python 3.8+ 与 pip 包管理工具，Linux/macOS 建议提前配置基础运行依赖。

5.2 方式一：pip 快速安装（推荐新手）

打开系统终端/命令提示符，执行以下命令完成一键安装：

pip install dulus

安装完成后，直接在终端输入启动命令即可运行：

dulus

首次启动默认连接免费云端模型，无需任何额外配置，直接进入对话交互界面。

5.3 方式二：源码部署（适合二次开发）

1. 克隆GitHub源码仓库

git clone https://github.com/KevRojo/Dulus.git

2. 进入项目目录

cd Dulus

3. 安装项目依赖

pip install -r requirements.txt

4. 启动程序

python cli.py

5.4 方式三：Docker 容器部署（适合服务器）

该方式无需配置本地Python环境，适合服务器、云主机使用，执行docker compose命令一键启动：

docker compose up -d

容器启动后，通过指定端口即可访问Dulus服务，后台静默运行，稳定持久。

5.5 常用基础指令

进入交互界面后，可使用内置快捷指令实现功能切换：

• /lang 语言名：切换对话与界面语言，例：/lang zh-CN 切换为简体中文；

• /model：查看、切换当前使用的大模型；

• /clear：清空当前会话上下文；

• /memory：查看、管理本地语义记忆。

六、竞品对比

选取当下主流两款开源AI代理框架 AutoGPT、AgentGPT 与 Dulus 进行横向对比，从部署难度、模型调用、功能特性、使用成本、运行环境五个核心维度分析，表格如下：

总结对比：AutoGPT与AgentGPT是老牌经典AI代理框架，自动化任务逻辑成熟，但均强制要求API密钥，使用成本高、部署复杂；而Dulus最大优势为零密钥、零成本、轻量化，工具集更丰富，离线与隐私场景适配更强，更适合个人用户、新手以及注重成本与数据安全的使用者。

七、常见问题解答

Q1：Dulus 调用云端模型安全吗，是否存在账号风险？

A：Dulus 仅使用各大AI平台公开的访客临时会话通道，不会读取、登录用户私人账号，也不会要求输入账号密码，全程不涉及个人账户信息，不存在账号被盗、封禁等风险。

Q2：运行时提示Python版本过低该如何解决？

A：项目要求Python 3.8及以上版本，出现该提示只需前往Python官网下载并安装高版本Python，重新配置系统环境变量后，再次执行安装与启动命令即可。

Q3：云端模型响应缓慢或者连接失败怎么办？

A：可以切换内置的NVIDIA NIM免费模型，或是切换至Ollama本地模型离线使用；同时框架自带自动降级机制，会自动切换可用模型，也可执行/model指令手动更换模型源。

Q4：能否在企业内部、涉密场景使用该项目？

A：可以。建议关闭云端模型，全程对接Ollama本地大模型，结合内置沙盒环境运行，所有数据均保存在本地设备，不对外传输，满足数据保密要求。

Q5：如何安装第三方插件扩展功能？

A：依托项目Auto-Adapter自动适配功能，直接将第三方Python插件放入项目plugins目录，重启Dulus即可自动识别并加载，无需手动编写配置文件。

Q6：Docker部署后无法访问服务是什么原因？

A：优先检查服务器防火墙、端口放行规则，确认容器对应端口已对外开放；其次查看Docker容器运行状态，若容器异常停止，可查看日志排查依赖缺失问题。

Q7：语义记忆功能可以手动清空吗？

A：可以。在交互终端中执行/memory clear指令，即可一键清空本地存储的语义记忆，也可单独删除单条项目记忆。

八、相关链接

1. GitHub仓库：https://github.com/KevRojo/Dulus

2. 官网地址：https://dulus.ai/

九、总结

Dulus作为一款轻量化开源Python AI代理框架，凭借免API密钥调用主流大模型、丰富的内置工具集、完善的多代理协作能力、安全的沙盒运行环境以及极低的部署门槛，形成了区别于传统AI代理工具的核心优势。项目遵循GPLv3开源协议，核心功能永久免费，全平台兼容且同时支持云端联网使用与本地离线部署，既降低了普通用户使用高级AI能力的门槛，也为开发者提供了稳定、易拓展的二次开发底座。无论是个人日常问答、办公提效、编程运维，还是小型团队社群协作、涉密离线AI场景，Dulus都能良好适配，是目前轻量化免费AI代理领域实用性极强的开源项目。