{"id":"autogenstudio","title":"AutoGen Studio","library":"autogenstudio","description":"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.","status":"maintenance","version":"0.4.x (last stable PyPI release: May 2025)","install":[{"cmd":"pip install -U autogenstudio","lang":"bash","label":"Install AutoGen Studio"},{"cmd":"autogenstudio ui --port 8080 --appdir ./myapp","lang":"bash","label":"Launch the web UI"}],"dependencies":[{"package":"Python >=3.10","reason":"Hard requirement.","optional":false},{"package":"autogen-agentchat, autogen-ext[openai]","reason":"AutoGen Studio is built on top of the AutoGen AgentChat API (v0.4). These are pulled in transitively but must be compatible versions.","optional":false}],"imports":[{"symbol":"CLI launch","correct":"autogenstudio ui --port 8080 --appdir ./myapp","wrong":"autogenstudio --port 8080","note":"The 'ui' subcommand is required. Running autogenstudio alone without a subcommand does nothing useful."}],"quickstart":{"code":"pip install -U autogenstudio\nautogenstudio ui --port 8080 --appdir ./myapp\n# Open http://localhost:8080 in your browser\n# Set OPENAI_API_KEY in .env file inside --appdir directory","lang":"bash","description":"Install and launch AutoGen Studio UI"},"warnings":[{"severity":"breaking","message":"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.","affected_versions":"all","fix":"For new projects, evaluate Microsoft Agent Framework (https://aka.ms/autogen-to-af). Existing AutoGen Studio deployments remain functional."},{"severity":"breaking","message":"AutoGen Studio is explicitly NOT production-ready per official documentation. Breaking changes are expected between releases with no migration guarantees.","affected_versions":"all","fix":"Use AutoGen Studio for prototyping only. For production, use autogen-agentchat programmatically or Microsoft Agent Framework."},{"severity":"breaking","message":"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).","affected_versions":"all","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"},{"severity":"breaking","message":"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.","affected_versions":"all","fix":"Create a .env file in the appdir: echo 'OPENAI_API_KEY=sk-...' > ./myapp/.env"},{"severity":"gotcha","message":"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.","affected_versions":"all","fix":"Always pass --appdir explicitly: autogenstudio ui --appdir /path/to/consistent/dir"},{"severity":"gotcha","message":"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.","affected_versions":"all","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."},{"severity":"gotcha","message":"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.","affected_versions":"all","fix":"pip install autogenstudio separately. Do not assume it is bundled with other AutoGen packages."}],"last_verified":"2026-02-28","next_check":"2026-05-28","source_url":"https://microsoft.github.io/autogen/stable/user-guide/autogenstudio-user-guide/installation.html","language":"en","source_language":"en","tags":["agents","orchestration","autogen","microsoft","no-code","ui","prototyping","python","maintenance-mode"]}