{"id":13642969,"url":"https://github.com/victordibia/autogen-ui","last_synced_at":"2025-05-15T03:08:58.359Z","repository":{"id":198760491,"uuid":"701102523","full_name":"victordibia/autogen-ui","owner":"victordibia","description":"Web UI for AutoGen (A Framework Multi-Agent LLM Applications)","archived":false,"fork":false,"pushed_at":"2024-11-14T00:31:12.000Z","size":2208,"stargazers_count":895,"open_issues_count":14,"forks_count":128,"subscribers_count":21,"default_branch":"main","last_synced_at":"2025-04-14T04:58:59.238Z","etag":null,"topics":["agent-based-framework","ai","ai-agents","autogen","autogen-sample","chatgpt","deep-learning","visualization"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/victordibia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-05T23:28:44.000Z","updated_at":"2025-04-12T00:57:03.000Z","dependencies_parsed_at":"2023-12-13T19:29:31.130Z","dependency_job_id":"c3d56edb-2580-433b-93f0-9245f956b3de","html_url":"https://github.com/victordibia/autogen-ui","commit_stats":null,"previous_names":["victordibia/autogen-ui"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victordibia%2Fautogen-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victordibia%2Fautogen-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victordibia%2Fautogen-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victordibia%2Fautogen-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/victordibia","download_url":"https://codeload.github.com/victordibia/autogen-ui/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254264771,"owners_count":22041794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-based-framework","ai","ai-agents","autogen","autogen-sample","chatgpt","deep-learning","visualization"],"created_at":"2024-08-02T01:01:38.795Z","updated_at":"2025-05-15T03:08:53.350Z","avatar_url":"https://github.com/victordibia.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","SDK, Libraries, Frameworks"],"sub_categories":["Other sdk/libraries"],"readme":"# AutoGen UI\n\n![AutoGen UI Screenshot](docs/images/autogenuiscreen.png)\n\n\u003e [!IMPORTANT]  \n\u003e This repo has been updated to use the [AutoGen AgentChat](https://microsoft.github.io/autogen/dev/user-guide/agentchat-user-guide/quickstart.html) interface based on the new AutoGen 0.4x AgentChat api. Also, the API might change, so expect some breaking changes in the future.\n\nThe hello world for building a UI interface with AutoGen AgentChat API.\n\nExample UI to demonstrate how to build interfaces using the [AutoGen AgentChat](https://github.com/microsoft/autogen) API. The UI is built using Next.js and web apis built using FastApi.\n\n## What Does the App Do?\n\n![AutoGen UI Flow Diagram](docs/images/flowdiag.png)\n\n- [`autogenui.manager`](autogenui/manager.py) - provides a simple run method that takes a prompt and returns a response from a predefined [agent team](notebooks/default_team.json). Take a look at the [agent team](notebooks/default_team.json) json config file to see how the agents are configured. It gives a general idea on what types of agents are supported etc. Check out the [tutorial notebook](notebooks/tutorial.ipynb) for an example on how to use the provide class to load a team spec.\n\n- [`autogenui.web.app.py`](autogenui/web/app.py) - FastApi backend that serves a simple `/generate` endpoint that takes a prompt and returns a response from a predefined [agent team](notebooks/default_team.json).\n\n  - Creates a manager to run tasks\n  - Streams results of the task run to the client ui\n\n- [`frontend`](frontend) - Next.js frontend that provides a simple chat interface to interact with the backend.\n\n## What's Next?\n\nThis app is clearly just a starting point. Here are some ideas on how to extend it:\n\n- Extend the manager to support multiple team configurations from the UI\n- Storing and loading interaction history in a database.\n- Security - add authentication and authorization to the app\n\n\u003e [!TIP] Note\n\u003e [AutoGen Studio](https://github.com/microsoft/autogen/tree/main/python/packages/autogen-studio) is being rewritten on the AgentChat api to address most of the above points. Take a look at the implementation there for a more complete example.\n\n## Getting Started\n\nNote that you will have to setup your OPENAI_API_KEY to run the app.\n\n```bash\nexport OPENAI_API_KEY=\u003cyour key\u003e\n```\n\nInstall dependencies. Python 3.9+ is required. You can install from pypi using pip.\n\n```bash\npip install autogenui\n```\n\nor to install from source\n\n```bash\ngit clone git@github.com:victordibia/autogen-ui.git\ncd autogenui\npip install -e .\n```\n\nRun ui server.\n\nSet env vars `OPENAI_API_KEY`\n\n```bash\nexport OPENAI_API_KEY=\u003cyour_key\u003e\n```\n\n```bash\nautogenui # or with --port 8081\n```\n\nOpen http://localhost:8081 in your browser.\n\nTo modify the source files, make changes in the frontend source files and run `npm run build` to rebuild the frontend.\n\n## Development\n\nTo run the app in development mode, you will need to run the backend and frontend separately.\n\n## Backend - with hot-reload\n\n```bash\nautogenui --reload\n```\n\n\u003e [!TIP] Tip\n\u003e The UI loaded by this CLI in a pre-complied version by running the frontend build command show blow. That means if you make changes the frontend code or change the hostname or port the backend is running on the frontend updated frontend code needs to be rebuilt for it to load through this command.\n\n## Frontend\n\n```bash\ncd frontend\n```\n\nInstall dependencies\n\n```bash\nyarn install\n```\n\nRun in dev mode - with hot-reload\n\nSet `NEXT_PUBLIC_API_SERVER` on the command line.\n\n```bash\nexport NEXT_PUBLIC_API_SERVER=http://\u003cyour_backend_hostname\u003e/api\n```\n\nOr create a `.env` file in the frontend folder with the following content.\n\n```bash\nNEXT_PUBLIC_API_SERVER=http://\u003cyour_backend_hostname\u003e/api\n```\n\nwhere your_backend_hostname - is the hostname that autogenui is running on e.g. `localhost:8081`\n\n```bash\nyarn dev\n```\n\n(Re)build\n\nRemember to install dependencies and set `NEXT_PUBLIC_API_SERVER` before building.\n\n```bash\nyarn build\n```\n\n## Roadmap\n\nThere isnt really much of a roadmap for this project. It is meant as a simple example to get started with the AutoGen AgentChat API. For a more complete example, take a look at the [AutoGen Studio](https://github.com/microsoft/autogen/tree/main/python/packages/autogen-studio) project.\n\n## References\n\n- [AutoGen Studio](https://arxiv.org/abs/2308.08155).\n\n```\n@inproceedings{dibia2024autogen,\n  title={AutoGen Studio: A No-Code Developer Tool for Building and Debugging Multi-Agent Systems},\n  author={Dibia, Victor and Chen, Jingya and Bansal, Gagan and Syed, Suff and Fourney, Adam and Zhu, Erkang and Wang, Chi and Amershi, Saleema},\n  journal={EMNLP 2024},\n  year={2024}\n}\n```\n\n- [AutoGen](https://arxiv.org/abs/2408.15247).\n\n```\n@inproceedings{wu2023autogen,\n      title={AutoGen: Enabling Next-Gen LLM Applications via Multi-Agent Conversation Framework},\n      author={Qingyun Wu and Gagan Bansal and Jieyu Zhang and Yiran Wu and Shaokun Zhang and Erkang Zhu and Beibin Li and Li Jiang and Xiaoyun Zhang and Chi Wang},\n      year={2023},\n      eprint={2308.08155},\n      archivePrefix={arXiv},\n      primaryClass={cs.AI}\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictordibia%2Fautogen-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvictordibia%2Fautogen-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictordibia%2Fautogen-ui/lists"}