magentic-ui README

The project's README from github.com/microsoft/magentic-ui. As one markdown file: README.md.

MagenticLite

Big tasks. Small models.

MagenticLite is the next generation of Magentic-UI — an agentic application from Microsoft AI Frontiers, redesigned to do more with less. It pairs an on-device-friendly orchestrator model (MagenticBrain) with a specialized browser-use model (Fara) so you can automate real work without depending on frontier-scale compute.

See it in action

Click any task below to expand and watch MagenticLite handle it end to end.

Fill expense forms

https://github.com/user-attachments/assets/a982b60d-127e-4310-96e6-9f094dffb7f0

Find prices for recipe ingredients

https://github.com/user-attachments/assets/7ff87917-752f-4e40-b319-8036e08ab8f9

Find and book a restaurant

https://github.com/user-attachments/assets/ee5f967e-ee1b-4554-b329-36b56b595aa4

Organize local files

https://github.com/user-attachments/assets/aff385dd-f856-4db4-8f26-08fd0f940aa4

Quick start

These steps get you running on macOS or Windows (WSL). Need more detail or a different platform? See the Installation Guide.

1. Install MagenticLite

# 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. Run

magentic-ui --port 8081

Open http://127.0.0.1:8081/ and follow the in-app onboarding to connect a model endpoint. If you don't have one yet, see the Model Hosting Guide.

Looking for the previous Magentic-UI 0.1 release (optimized to run with frontier models)? It lives on the magentic-ui-0.1 branch.

Documentation

Doc What's in it
Installation Supported platforms, macOS / WSL prerequisites, install + run commands
Build from source How to run MagenticLite from a clone of this repo (uv sync, pnpm dev, etc.)
Model hosting guide End-to-end walkthrough of standing up a model endpoint and connecting MagenticLite to it
Configuration Sandbox, agent mode, tool approval, full config.yaml example
Troubleshooting Common errors and how to fix them
Limitations Tasks and usage patterns MagenticLite doesn't handle well today
Transparency Note Intended uses, responsible-use guidance, risks, and mitigations

License

Microsoft, and any contributors, grant you a license to any code in the repository under the MIT License. See the LICENSE file.

Microsoft, Windows, Microsoft Azure, and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.

Any use of third-party trademarks or logos are subject to those third-party's policies.

Privacy information can be found at https://go.microsoft.com/fwlink/?LinkId=521839.

Microsoft and any contributors reserve all other rights, whether under their respective copyrights, patents, or trademarks, whether by implication, estoppel, or otherwise.

magentic-ui (microsoft/magentic-ui)

Searching Database…

10.1K ·GitHub
Magentic-ui
这是什么?MagenticLite 是微软 AI Frontiers 推出的一款免费开源智能体应用,能在浏览器和本地文件系统上自动化处理实际工作——比如在网上查资料、填写表单、管理文件——专为在小模型上运行而设计。
它是桌面应用,还是在浏览器里用的东西?它是一个本地安装的应用,带有网页界面:你在自己的电脑上运行它,然后通过浏览器来操作这个智能体,同时它还能处理你本地的文件。
我怎么把它跑起来?快速入门只需两步:先安装 MagenticLite,然后运行它——支持 macOS 和 Windows(WSL)。也有从源码构建的方式(uv sync、pnpm dev)。
我需要最顶尖的大模型或者付费的 API 密钥吗?不需要——它就是为小模型设计的:MagenticBrain 是一个适合在设备端运行的编排模型,Fara 是专门用于操作浏览器的模型,所以不需要顶级规模的算力。官方还提供了一份模型托管指南,带你一步步接入模型端点。
它有什么处理不好的地方吗?有。它还处于实验阶段,文档里专门有一个 Limitations(局限性)页面,列出了目前 MagenticLite 处理不好的任务和使用方式。
它和原来的 Magentic-UI 有什么不一样?MagenticLite 是下一代产品,重新设计的目标是用更少的资源做更多的事——它面向小模型,而不是顶级规模的算力。之前的 Magentic-UI 0.1 版本是针对大模型优化的,仍保留在 magentic-ui-0.1 分支上。
MagenticBrain 和 Fara 是什么?MagenticBrain 是 MagenticLite 的编排模型,适合在设备端运行;Fara 则是专门用于操作浏览器的模型。两者结合,让智能体无需庞大算力就能自动化处理实际工作。
我可以配置沙盒和审批吗?可以——Configuration(配置)文档介绍了沙盒设置、智能体模式和工具审批,其中还包括一个完整的 config.yaml 示例。
What are similar projects?collab-agent, hive, fara, open-dots, bytebot, Agent-S, SystemOneHarness, midscene
Which topics is it in?autogen, cua, task-automation, computer-use-agent, file-management, browser-use, wsl, human-in-the-loop, computer-use, microsoft, sandbox, browser-automation
Creator
microsoft
Size
52.4 MB
Stars
10.1K
Updated
CommitJul 23Releasev0.2.1May 21
Age
1y
Commits · 90 Days