Metadata-Version: 2.4
Name: magentic_ui
Version: 0.2.1
Summary: A research prototype of a human-centered interface powered by a multi-agent system
Project-URL: Homepage, https://github.com/microsoft/magentic-ui
Project-URL: Repository, https://github.com/microsoft/magentic-ui
Project-URL: Issues, https://github.com/microsoft/magentic-ui/issues
Author-email: Microsoft Corporation <magui@service.microsoft.com>
License-Expression: MIT
License-File: LICENSE
License-File: NOTICE
Keywords: agents,ai-assistant,browser-use,multi-agent,playwright,web-automation
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: aioconsole
Requires-Dist: aiofiles
Requires-Dist: alembic
Requires-Dist: azure-identity
Requires-Dist: fastapi[standard]
Requires-Dist: html2text
Requires-Dist: jsonschema
Requires-Dist: loguru
Requires-Dist: markitdown~=0.1.5
Requires-Dist: nest-asyncio
Requires-Dist: openai>=1.0.0
Requires-Dist: pillow
Requires-Dist: pip>=24
Requires-Dist: playwright<1.61,>=1.58
Requires-Dist: psutil
Requires-Dist: psycopg
Requires-Dist: pydantic
Requires-Dist: pydantic-settings
Requires-Dist: python-dotenv
Requires-Dist: pyyaml
Requires-Dist: quick-sandbox[cua,qemu]~=0.11.14
Requires-Dist: quicksand-cua>=0.3.10
Requires-Dist: sqlmodel
Requires-Dist: tenacity
Requires-Dist: tiktoken<0.14,>=0.12
Requires-Dist: typer
Requires-Dist: websockets
Description-Content-Type: text/markdown

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="docs/_assets/magentic-lite-logo-dark.png">
    <img src="docs/_assets/magentic-lite-logo-light.png" alt="MagenticLite" width="420">
  </picture>
</p>

<p align="center">
  <em>Big tasks. Small models.</em>
</p>

---

**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](https://huggingface.co/microsoft/MagenticBrain)) with a specialized browser-use model ([Fara](https://huggingface.co/microsoft/Fara1.5-9B)) 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](https://microsoft.github.io/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.

<details open>
  <summary><b>Fill expense forms</b></summary>

  https://github.com/user-attachments/assets/2dd207ae-bd55-4b20-8c68-c028dda6c203

</details>

<details>
  <summary><b>Find prices for recipe ingredients</b></summary>

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

</details>

<details>
  <summary><b>Find and book a restaurant</b></summary>

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

</details>

<details>
  <summary><b>Organize local files</b></summary>

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

</details>

## Quick start

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

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

```bash
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](./docs/model-hosting-guide.md).

> **Looking for the previous Magentic-UI 0.1 release** (optimized to run with frontier models)? It lives on the [`magentic-ui-0.1`](https://github.com/microsoft/magentic-ui/tree/magentic-ui-0.1) branch.

## Documentation

| Doc                                                  | What's in it                                                                             |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| [Installation](./docs/installation.md)               | Supported platforms, macOS / WSL prerequisites, install + run commands                   |
| [Build from source](./docs/build-from-source.md)     | How to run MagenticLite from a clone of this repo (`uv sync`, `pnpm dev`, etc.)          |
| [Model hosting guide](./docs/model-hosting-guide.md) | End-to-end walkthrough of standing up a model endpoint and connecting MagenticLite to it |
| [Configuration](./docs/configuration.md)             | Sandbox, agent mode, tool approval, full `config.yaml` example                           |
| [Troubleshooting](./docs/troubleshooting.md)         | Common errors and how to fix them                                                        |
| [Limitations](./docs/limitations.md)                 | Tasks and usage patterns MagenticLite doesn't handle well today                          |
| [Transparency Note](./docs/TRANSPARENCY_NOTE.md)     | 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](https://opensource.org/licenses/MIT). See the [LICENSE](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.
