> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/microsoft/magentic-ui) · [上游 README](https://github.com/microsoft/magentic-ui/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
大任务。小模型。
---
**MagenticLite** 是 Magentic-UI 的下一代版本——一款来自 **Microsoft AI Frontiers** 的智能体（agentic）应用，经过重新设计，以更少的资源完成更多工作。它将适合本地运行的编排模型（[MagenticBrain](https://aka.ms/MagenticBrain-foundry)) with a specialized browser-use model ([Fara](https://aka.ms/fara-foundry)) so you can automate real work without depending on frontier-scale compute.
- **专为小模型打造，设计上高效。** 无需沉重算力即可获得强大的智能体性能——不必依赖前沿级大模型。
- **横跨浏览器与本地文件系统。** 网络调研、表单填写、文件管理——同一工作流内一气呵成。
- **让你始终参与并掌控全局。** 随时引导、审批或接管。MagenticLite 在执行关键操作前会暂停并征求确认。
- **安全优先的设计。** 浏览器会话在轻量级 VM 沙箱（[Quicksand](https://microsoft.github.io/quicksand/)) so the agent can't reach the rest of your machine without your say-so.
## 亲眼见证
点击以下任意任务即可展开，观看 MagenticLite 端到端完成全过程。
填写报销表单
https://github.com/user-attachments/assets/a982b60d-127e-4310-96e6-9f094dffb7f0
查找食谱食材价格
https://github.com/user-attachments/assets/7ff87917-752f-4e40-b319-8036e08ab8f9
查找并预订餐厅
https://github.com/user-attachments/assets/ee5f967e-ee1b-4554-b329-36b56b595aa4
整理本地文件
https://github.com/user-attachments/assets/aff385dd-f856-4db4-8f26-08fd0f940aa4
## 快速开始
以下步骤可在 macOS 或 Windows（WSL）上运行。需要更多细节或其他平台？请参阅[安装指南](./docs/installation.md)。
### 1. 安装 MagenticLite
```bash
# Create a project directory
mkdir magentic-lite && cd magentic-lite
# Create and activate a virtual environment
uv venv --python=3.12 --seed .venv
source .venv/bin/activate
# Install the latest 0.2.x release from PyPI
uv pip install "magentic_ui>=0.2.0"
```
### 2. 运行
```bash
magentic-ui --port 8081
```
打开 并按照应用内引导连接模型端点。若你尚无可用端点，请参阅[模型托管指南](./docs/model-hosting-guide.md)。
> **在找此前的 Magentic-UI 0.1 版本**（针对前沿模型优化）？它位于 [`magentic-ui-0.1`](https://github.com/microsoft/magentic-ui/tree/magentic-ui-0.1) branch。
## 文档
| 文档 | 内容 |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| [安装](./docs/installation.md) | 支持的平台、macOS / WSL 前置条件、安装与运行命令 |
| [从源码构建](./docs/build-from-source.md) | 如何从本仓库克隆运行 MagenticLite（`uv sync`、`pnpm dev` 等） |
| [模型托管指南](./docs/model-hosting-guide.md) | 搭建模型端点并将 MagenticLite 与之连接的端到端指南 |
| [配置](./docs/configuration.md) | 沙箱、智能体模式、工具审批，以及完整的 `config.yaml` 示例 |
| [故障排除](./docs/troubleshooting.md) | 常见错误及修复方法 |
| [限制](./docs/limitations.md) | MagenticLite 目前尚难胜任的任务与使用模式 |
| [透明度说明](./docs/TRANSPARENCY_NOTE.md) | 预期用途、负责任使用指引、风险及缓解措施 |
## 许可证
Microsoft 及其任何贡献者，根据 [MIT License](https://opensource.org/licenses/MIT). See the [LICENSE](LICENSE) file.
Microsoft、Windows、Microsoft Azure 及/或文档中提及的其他 Microsoft 产品与服务，可能是 Microsoft 在美国及/或其他国家/地区的商标或注册商标。本项目的许可并不授予你使用任何 Microsoft 名称、标识或商标的权利。Microsoft 的一般商标使用准则见 。
任何第三方商标或标识的使用均须遵守相应第三方的政策。
隐私信息见 。
Microsoft 及任何贡献者保留所有其他权利，无论基于其各自的版权、专利或商标，无论通过默示、禁止反言或其他方式。
