MCPcopy Index your code
hub / github.com/microsoft/magentic-ui

github.com/microsoft/magentic-ui @v0.2.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.2.1 ↗ · + Follow
2,447 symbols 8,639 edges 328 files 943 documented · 39% 25 cross-repo links updated 1d agov0.2.1 · 2026-05-21★ 9,942

Browse by type

Functions 1,935 Types & classes 459 Endpoints 53
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
<img src="https://github.com/microsoft/magentic-ui/raw/v0.2.1/docs/_assets/magentic-lite-logo-light.png" alt="MagenticLite" width="420">

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.

  • Built for small models, efficient by design. Strong agentic performance without heavy compute — no frontier-scale models required.
  • Works across the browser and your local file system. Web research, form filling, file management — in one workflow.
  • Keeps you in the loop and in control. Steer, approve, or take over at any point. MagenticLite stops and checks in before taking critical actions.
  • Safe by design. Browser sessions run inside a lightweight VM sandbox (Quicksand) so the agent can't reach the rest of your machine without your say-so.

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/2dd207ae-bd55-4b20-8c68-c028dda6c203

Find prices for recipe ingredients

https://github.com/user-attachments/assets/dc8bd475-4ea4-4745-9730-f9d0f9c0a167

Find and book a restaurant

https://github.com/user-attachments/assets/9c1fab57-f1cd-46c5-88e1-4e129a18e396

Organize local files

https://github.com/user-attachments/assets/3df94294-68ed-4335-ba04-3f2ff5384866

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.

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Method 1,098
Function 837
Class 278
Interface 181
Route 53

Languages

Python77%
TypeScript23%

Modules by API surface

tests/agents/fara/test_fara_qwen3.py99 symbols
tests/test_file_upload_tracking.py98 symbols
tests/test_command_policy.py72 symbols
tests/agents/omni/test_context_compaction.py67 symbols
tests/test_quicksand_browser.py66 symbols
tests/test_verifier.py65 symbols
src/magentic_ui/tools/playwright/playwright_controller_fara.py47 symbols
tests/agents/omni/test_guest_tools_integration.py43 symbols
tests/test_auth_middleware.py42 symbols
src/magentic_ui/backend/web/managers/connection.py35 symbols
tests/test_onboarding.py33 symbols
src/magentic_ui/agents/message_schemas.py31 symbols

Dependencies from manifests, versioned

@eslint/eslintrc3.3.5 · 1×
@eslint/js9.39.4 · 1×
@radix-ui/react-checkbox1.3.3 · 1×
@radix-ui/react-dialog1.1.15 · 1×
@radix-ui/react-dropdown-menu2.1.16 · 1×
@radix-ui/react-slot1.2.4 · 1×
@tailwindcss/vite4.3.0 · 1×

For agents

$ claude mcp add magentic-ui \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page