Skip to content

Install

Prerequisites

  • Python 3.10 or later
  • An OpenAI API key with access to GPT-4o (set as OPENAI_API_KEY in your environment)
  • Docker (strongly recommended for isolating code execution and browser activity)

Step 1 - Install the Python packages

bash
pip install "autogen-agentchat" "autogen-ext[magentic-one,openai]"

This installs:

  • autogen-agentchat - the AutoGen agent chat framework
  • autogen-ext[magentic-one,openai] - the Magentic-One team and OpenAI model client

Step 2 - Install Playwright and the Chromium browser

Magentic-One's MultimodalWebSurfer drives a real Chromium browser via Playwright. Install the browser binary:

bash
playwright install --with-deps chromium

The --with-deps flag pulls in all OS-level libraries Chromium needs (libnss, libatk, etc.). On headless Linux servers this is required.

Run tasks inside a container to prevent the Coder and ComputerTerminal agents from touching your host filesystem or network:

bash
docker pull mcr.microsoft.com/devcontainers/python:3.11

Then run your script inside the container with the packages installed.

No CLI entry point

Magentic-One does not ship a standalone CLI binary. All usage is through the Python API (see Usage).