AutoGen Studio

raw JSON →

0.4.x (last stable PyPI release: May 2025) verified Mon May 11 auth: no python install: stale quickstart: stale maintenance

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.

pip install -U autogenstudio

Common errors

error ModuleNotFoundError: No module named 'autogenserver' ↓

cause This error occurs when the 'autogenserver' module is not installed or not found in the Python environment.

fix

Ensure that 'autogenstudio' is installed correctly by running 'pip install autogenstudio'.

error ImportError: cannot import name 'AgentConfig' from 'autogenstudio' ↓

cause This error occurs when attempting to import 'AgentConfig' from 'autogenstudio', but the module does not contain this name.

fix

Verify the correct import path for 'AgentConfig' in the 'autogenstudio' package, and ensure that the module is up to date.

error AttributeError: module 'autogenstudio' has no attribute 'initiate_chat' ↓

cause This error occurs when trying to access the 'initiate_chat' attribute, which does not exist in the 'autogenstudio' module.

fix

Check the 'autogenstudio' documentation for the correct method to initiate a chat, and update the code accordingly.

error TypeError: 'NoneType' object is not iterable ↓

cause This error occurs when attempting to iterate over a 'None' object, possibly due to a missing or incorrect configuration in 'autogenstudio'.

fix

Ensure that all configurations and inputs required by 'autogenstudio' are properly set and not 'None'.

error ValueError: Unsupported agent type: 'CustomAgent' ↓

cause This error occurs when specifying an agent type that is not supported by 'autogenstudio'.

fix

Use one of the supported agent types as specified in the 'autogenstudio' documentation.

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.

breaking `pip install` is a shell command and cannot be executed directly within a Python script, leading to `SyntaxError: invalid syntax`. It must be run from a shell or through a subprocess call in Python. ↓

fix Run `pip install -U autogenstudio` directly in your terminal or shell. If you need to install packages programmatically from within a Python script, use `import subprocess; subprocess.check_call(['pip', 'install', '-U', 'autogenstudio'])`.

breaking Installing Python packages that require C extensions (e.g., numpy, scipy) often fails in minimal Linux environments (like Alpine) due to missing C compilers and build-essential tools. The `pip` installation process attempts to compile native code, which requires tools like `gcc` or `clang`. ↓

fix Ensure C compilers and development headers are installed in your environment. For Alpine Linux, add `build-base` and `python3-dev`: `apk add build-base python3-dev`. For Debian/Ubuntu, install `build-essential` and `python3-dev`: `apt-get update && apt-get install -y build-essential python3-dev`.

Install

autogenstudio ui --port 8080 --appdir ./myapp

Install compatibility stale last tested: 2026-05-11

python os / libc status wheel install import disk

3.10 alpine (musl) - - - -

3.10 slim (glibc) - - - -

3.11 alpine (musl) - - - -

3.11 slim (glibc) - - - -

3.12 alpine (musl) - - - -

3.12 slim (glibc) - - - -

3.13 alpine (musl) - - - -

3.13 slim (glibc) - - - -

3.9 alpine (musl) - - - -

3.9 slim (glibc) - - - -

Imports

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

Quickstart stale last tested: 2026-05-11

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