AutoGen Studio

0.4.x (last stable PyPI release: May 2025) · maintenance · verified Sat Feb 28

Microsoft's no-code/low-code web UI for prototyping AutoGen multi-agent workflows. Built on FastAPI (backend) and Gatsby/React (frontend). Stores agent configs, sessions, and workflows in a local SQLite or PostgreSQL database. Explicitly NOT production-ready — intended for rapid prototyping only.

Warnings

breaking Microsoft has announced AutoGen is now in maintenance-only mode (critical bug fixes and security patches only — no new features). New feature development has moved to Microsoft Agent Framework. Existing AutoGen/AutoGen Studio code continues to work but the project will not receive new capabilities.
Fix: For new projects, evaluate Microsoft Agent Framework (https://aka.ms/autogen-to-af). Existing AutoGen Studio deployments remain functional.
breaking AutoGen Studio is explicitly NOT production-ready per official documentation. Breaking changes are expected between releases with no migration guarantees.
Fix: Use AutoGen Studio for prototyping only. For production, use autogen-agentchat programmatically or Microsoft Agent Framework.
breaking Upgrading AutoGen Studio between versions can corrupt the local SQLite database. Known SQLite ALTER COLUMN errors occur when schema migrations run on existing databases (SQLite does not support column type changes natively).
Fix: Before upgrading, back up ~/.autogenstudio/database.sqlite. If migration fails, delete the database file and restart: rm ~/.autogenstudio/database.sqlite && autogenstudio ui --upgrade-database
breaking AutoGen Studio requires OPENAI_API_KEY to be set in a .env file inside the --appdir directory, NOT as a system environment variable. Setting it in the shell environment alone does not work.
Fix: Create a .env file in the appdir: echo 'OPENAI_API_KEY=sk-...' > ./myapp/.env
gotcha AutoGen Studio stores all data (agents, workflows, sessions) in ~/.autogenstudio by default. If --appdir is not specified on every launch, data from different invocations may end up in different locations.
Fix: Always pass --appdir explicitly: autogenstudio ui --appdir /path/to/consistent/dir
gotcha Building from source requires git-lfs. Cloning the repo without git-lfs installed will cause build errors on the frontend due to missing image/asset files.
Fix: Install git-lfs before cloning: brew install git-lfs (macOS) or apt-get install git-lfs (Ubuntu). Run git lfs install && git lfs fetch --all after cloning.
gotcha AutoGen Studio (autogenstudio) is a completely separate package from autogen-agentchat and must be installed independently. It is not included in any autogen-agentchat or autogen-ext install.
Fix: pip install autogenstudio separately. Do not assume it is bundled with other AutoGen packages.

Install

pip install -U autogenstudio Install AutoGen Studio
autogenstudio ui --port 8080 --appdir ./myapp Launch the web UI

Imports

CLI launch
```
autogenstudio ui --port 8080 --appdir ./myapp
```
The 'ui' subcommand is required. Running autogenstudio alone without a subcommand does nothing useful.

Quickstart

Install and launch AutoGen Studio UI

pip install -U autogenstudio
autogenstudio ui --port 8080 --appdir ./myapp
# Open http://localhost:8080 in your browser
# Set OPENAI_API_KEY in .env file inside --appdir directory

view raw JSON →