Ailice

可将复杂指令拆解为协作子任务的自托管通用 AI 助手。

Star 数
★ 1.4k
最近更新
1 年前
License
MIT
主语言
Python

30 秒速览

运行形态
命令行工具网页应用自托管服务
可在哪里用
通用 · 跨平台OpenAI API · Claude API
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
PythonChromeShell / 命令行网络访问本地文件系统MCP Server
典型场景
需要在本机或容器中完成研究、资料阅读与结果汇总的个人用户。
不适合
  • 只有 Windows 环境且需要命令行执行能力的用户
  • 硬件不足 48GB 显存却想本地跑大模型的用户

这个 Agent 能做什么,适合哪些场景?

Ailice 是一个以开源 LLM 为基础的自主通用助手,可通过浏览器提供对话界面。其核心计算模型为 IACT(Interactive Agents Call Tree):AProcessor 可创建子代理、向调用方请求补充信息,并将结果返回到调用链中。LLM 输出由 core/Interpreter.py 解析为函数调用、变量操作及其他动作,外围模块以独立进程方式提供搜索、浏览、代码执行、向量数据库等能力。项目支持统一模型配置,也支持通过 config.json 为不同类型代理指定不同模型。它可本地运行或使用 Docker 隔离运行,并可将 stdio 或 SSE MCP 服务器包装为扩展模块。

用户通过 ailice 或 ailice_web 启动服务,并在网页对话界面提交任务。主代理可将请求分配给不同子代理;AProcessor 在多轮对话中调用外围模块,Interpreter 将匹配的 LLM 文本解析为操作。系统支持变量定义、变量引用、文本拼接和函数调用;代码块可被保存为变量后再交给执行模块。config.json 的 services 可启动独立模块进程,或用 ailice_mcp_wrapper 将本地 stdio MCP 服务和 SSE MCP 服务接入;任务完成后将结果返回至对话链路。

  1. 需要在本机或容器中完成研究、资料阅读与结果汇总的个人用户。
  2. 需要让助手执行编程、脚本运行或系统管理类多步骤任务的开发者。
  3. 希望通过 config.json 为主代理、搜索代理等不同代理配置不同模型的团队。
  4. 需要将自建 stdio 或 SSE MCP 服务器接入助手工具链的集成开发者。
  5. 需要语音对话、图片/音频/视频富媒体界面及文件上传下载能力的本地部署用户。

如何安装或部署这个 Agent?

安装前准备 Python 与 Chrome。执行:

git clone https://github.com/myshell-ai/AIlice.git
cd AIlice

pip install -e .

如需 PDF 阅读、语音、Hugging Face 模型或微调功能,按需安装 pip install -e .[pdf-reading]、pip install -e .[speech]、pip install -e .[huggingface] 或 pip install -e .[finetuning]。需要隔离运行时可执行 docker build -t ailice .,再执行 docker run -it -p 127.0.0.1:5000:5000 --name ailice ailice --expose=1 --contextWindowRatio=0.2。

如何使用这个 Agent?

首次运行会要求输入 API key;也可编辑启动时输出位置的 config.json。首次可执行:

ailece --contextWindowRatio=0.2

该命令在源码示例中应为 ailice:

ailece 不是已文档化命令;请使用 ailice --contextWindowRatio=0.2。

启动后打开其提供的网页,在对话框输入任务。可指定模型,例如 ailice --modelID=anthropic:claude-sonnet-4-20250514 --contextWindowRatio=0.2;不指定 modelID 时,会使用 config.json 中 agentModelConfig 为不同代理设置的模型。运行参数可通过 ailice --help 查看。要接入 MCP,在 config.json 的 services 中配置 ailice_mcp_wrapper,例如以 stdio 模式包装 mcp_echo hello。

这个 Agent 有哪些优点和局限?

优点
  • IACT 调用树允许子代理在遇到信息不足或困难时向调用方回询,而非只有单向函数调用。
  • 外围能力以独立进程模块提供,模块可在不同软件、硬件或远程环境运行。
  • 已文档化支持将 stdio 与 SSE MCP 服务器通过 ailice_mcp_wrapper 接入。
  • 同时支持商业模型、OpenRouter/Apipie、Hugging Face 本地模型,以及兼容 OpenAI API 的推理服务。
  • 支持按代理类型配置模型,便于在性能、成本与本地资源之间组合取舍。
局限
  • 默认使用 Google 模块时存在频率限制;高频使用需申请 Custom Search JSON API 凭据并安装 google-api-python-client。
  • 本地高质量复杂任务的文档建议使用 70B 以上模型,并称有效运行至少需要两张 RTX 4090(48GB 显存)。
  • 最佳支持环境是 Ubuntu;Windows 未集成命令执行工具且测试较少,文档建议 Docker 或 WSL。
  • 首次使用开源模型、语音识别或 TTS 时可能需要下载权重,耗时并占用磁盘空间。
  • 公开分享链接功能因安全原因暂时移除,且文档明确警告不要将 app.py 服务暴露给不可信网络。

这个 Agent 与同类方案有什么区别?

Ailice 可直接使用官方 OpenAI、Mistral、Anthropic 与 Groq 模型接口;也可通过 OpenRouter 或 Apipie 路由模型。对于本地或非 OpenAI 兼容推理服务,文档给出了 LM Studio,以及 Ollama 加 LiteLLM 转换为 OpenAI 兼容接口的配置路径。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Ailice 当前 41 · 缺口较多 命令行工具免费 + 模型费 ★ 1.4k 1 年前 Python OpenAI API · Claude API
Hermes Agent 74 · 存在缺口 命令行工具免费 + 模型费 ★ 262k 今天 Python OpenAI API
Keinsaas Navigator 72 · 存在缺口 自托管服务免费 + 模型费 ★ 1.2k 2 天前 TypeScript OpenAI API · Claude API
WebBrain 68 · 存在缺口 浏览器扩展免费 + 模型费 ★ 1.7k 今天 JavaScript Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
41/ 100 五分制 2.1 / 5
信任安全 6/29
可靠稳定 5/14
适用触发 10/18
规范维护 11/18
有效结果 6/13
证据核验 3/8
查看各维度的扣分理由
信任安全6 / 29 · 1.0/5

代码和文档表明 AIlice 默认可控制本地环境,并可配置任意模块启动命令;README 也称其可执行系统管理和脚本任务,因此最小权限与外部影响控制较弱(0)。用户可通过配置模块和服务,但材料未显示针对高影响操作的确认机制(1)。文档说明 API 密钥写入配置、聊天历史保存路径及服务通信配置,却未充分说明数据保留或传输边界(数据流透明度 1;敏感数据处理 1)。README 建议使用虚拟机或 Docker 来限制风险,并提及备份恢复以外的恢复机制有限(回滚 1)。依赖使用大量通配符或宽版本范围,材料未显示安全审计或缓解措施(依赖安全 0)。作者署名和 MIT 许可证可见,但没有清晰的安全报告或维护联系流程(来源归属 1)。

可靠稳定5 / 14 · 1.8/5

README 描述的能力与入口代码部分吻合,但文档同时推荐旧版和较新的模型示例,且 `ailice` 与 `ailice_web` 入口有不同实现细节,故自洽性仅部分成立(1)。依赖列表较广,许多版本未锁定;文档也提醒可选功能可能产生依赖冲突(依赖可用性 1)。代码会记录异常并在模块启动失败时重试,但部分初始化错误直接打印后退出,错误恢复和用户可操作指引有限(失败消息 1)。

适用触发10 / 18 · 2.8/5

README 覆盖研究、编码、文档、语音和系统管理等场景,并说明本地模型与商业模型的配置方式(受众与场景 2)。文档明确指出 Windows 命令执行尚未集成、Windows 缺少测试,并提醒高风险本地控制及公开访问风险(能力边界 2)。示例任务具体,但整体产品定位为通用自主代理,未清楚约束何时应调用各能力或何时拒绝任务(触发精度 1)。安装说明涉及 Ubuntu、macOS、Windows/WSL、Docker、CUDA 与可选功能,环境指导较实用但并非各平台同等成熟(环境适配 2)。

规范维护11 / 18 · 3.1/5

README 有目录、分节安装说明、配置与模型指南,结构清楚但材料未提供完整文档内容(信息架构 2)。安装步骤、系统要求和可选依赖说明较充分,但环境变量和安全配置仍需用户自行判断(安装说明 2)。产品名、命令入口和代理类型在材料中基本稳定(命名稳定性 2)。README 有大量具体用例和实用提示,但没有明显的常见问题答疑部分(示例与 FAQ 2)。文档说明 Windows 限制、模型硬件要求、Google 访问限制及共享功能暂时移除(已知限制 2)。许可证文本完整且与元数据一致(许可证 3)。README 有日期更新条目,但没有清晰的版本变更记录或与当前修订的对应关系(版本与变更记录 1)。作者邮箱可见,但持续维护责任、维护周期和问题处理路径不够明确(维护责任 1)。

有效结果6 / 13 · 2.3/5

产品提供网页对话界面、模型选择、历史存储和多种工具模块;但材料没有展示输出质量、格式稳定性或可直接复用的结果保障(输出可用性 1)。动态代理树、模块扩展和多模型配置可能为复杂任务带来实际增益,文档给出了相应场景(边际价值 2)。本地模型可能需要至少两张 RTX 4090,语音和其他可选模块还需下载模型;成本与资源需求有说明,但没有按任务提供成本估算或替代方案比较(成本效益 1)。

证据核验3 / 8 · 1.9/5

README 对功能和能力的描述大多是项目方陈述,部分配置及启动行为可由代码和项目配置对应,但具体能力结果缺少支撑材料(主张可追溯性 1)。README、入口代码、依赖配置和安装工作流对项目结构及安装路径有少量相互印证;工作流仅在手动触发时运行,材料不能证明测试已执行(跨来源佐证 1)。文档有时将目标、示例任务和已具备能力并列,未持续区分演示设想与验证结果(事实与推断区分 1)。

风险与缓解建议
  • 源码中未见:最小权限约束只授予完成任务所需的权限:用专用账号或只读令牌,并限定可访问的目录和仓库。
  • 源码中未见:依赖安全审查安装前固定版本并做一次依赖扫描(如 npm audit、pip-audit);优先放在容器里运行。
  • 源码中未见:外部影响披露先弄清它会写入、发送或修改哪些外部系统,用测试账号或测试仓库验证后再接入正式环境。
  • 默认本地运行可能使代理对本机环境拥有较大控制权;高影响任务应优先使用隔离环境,并谨慎配置公开访问和模块启动命令。
  • 依赖范围较宽,且语音、PDF、Hugging Face 等可选功能会增加安装复杂度;请留意资源需求、密钥配置和聊天历史存储。
证据充分度:低 评估于 2026年11月8日 审查版本 63a22105cdf8
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/ailice.svg?lang=zh)](https://followagents.com/zh/agents/ailice)
<a href="https://followagents.com/zh/agents/ailice"><img src="https://followagents.com/badge/ailice.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.2.0-alpha 预发布
    发布说明摘录
    This is a stable version for the text-only modality stage, with prompts optimized for gpt4-turbo, and it also performs well on open-source models such as NousResearch/Nous-Hermes-2-Mixtral-8x7B-DPO. However, the voice interaction and web interface functionalities are not yet ideal. After the master branch starts the development task for multimodal functions, there might be cases of performance instability. It is recommended that users use this version as an alternative.
    在 GitHub 查看 ↗

常见问题

必须使用商业模型并支付 API 费用吗?
不一定。项目支持本地 Hugging Face 模型、LM Studio 和经 LiteLLM 转换的 Ollama 服务,也支持商业或聚合推理服务;首次启动仍会提示配置 API key。
能否把自己的 MCP 工具接入?
可以。可用 ailice_mcp_wrapper 将本地 stdio MCP 服务器或 SSE 地址包装为 Ailice 的标准 services 模块。
Windows 是否适合部署?
文档说明 Windows 的测试较少且尚未集成 Windows 命令执行工具;对需要执行编程任务的用户,建议使用 Docker 或 WSL。
为什么不应直接公开网页服务?
文档称公开 share 功能已因安全措施不足而暂时移除,并要求不要将 app.py 提供的服务暴露给不可信网络。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。