Tonic commited on
Commit
24ecade
·
1 Parent(s): 1bbfc0d

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +152 -2
README.md CHANGED
@@ -7,7 +7,157 @@ sdk: static
7
  sdk_version: 3.45.2
8
  app_file: README.md
9
  pinned: false
10
- license: unknown
11
  ---
12
 
13
- Check out the tutorial files at https://huggingface.co/spaces/MultiTransformer/autogen-tutorials/tree/main
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
7
  sdk_version: 3.45.2
8
  app_file: README.md
9
  pinned: false
10
+ license: mit
11
  ---
12
 
13
+ # Check out the tutorial files at :
14
+
15
+ - https://huggingface.co/spaces/MultiTransformer/autogen-tutorials/tree/main
16
+
17
+
18
+ [![PyPI version](https://badge.fury.io/py/pyautogen.svg)](https://badge.fury.io/py/pyautogen)
19
+ [![Build](https://github.com/microsoft/autogen/actions/workflows/python-package.yml/badge.svg)](https://github.com/microsoft/autogen/actions/workflows/python-package.yml)
20
+ ![Python Version](https://img.shields.io/badge/3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11-blue)
21
+ [![](https://img.shields.io/discord/1153072414184452236?logo=discord&style=flat)](https://discord.gg/pAbnFJrkgZ)
22
+
23
+ This project is a spinoff from [FLAML](https://github.com/microsoft/FLAML).
24
+
25
+ # AutoGen
26
+
27
+ <!-- <p align="center">
28
+ <img src="https://github.com/microsoft/autogen/blob/main/website/static/img/flaml.svg" width=200>
29
+ <br>
30
+ </p> -->
31
+
32
+ :fire: autogen has graduated from [FLAML](https://github.com/microsoft/FLAML) into a new project.
33
+
34
+ <!-- :fire: Heads-up: We're preparing to migrate [autogen](https://microsoft.github.io/FLAML/docs/Use-Cases/Autogen) into a dedicated github repository. Alongside this move, we'll also launch a dedicated Discord server and a website for comprehensive documentation.
35
+
36
+ :fire: FLAML is highlighted in OpenAI's [cookbook](https://github.com/openai/openai-cookbook#related-resources-from-around-the-web).
37
+
38
+ :fire: [autogen](https://microsoft.github.io/autogen/) is released with support for ChatGPT and GPT-4, based on [Cost-Effective Hyperparameter Optimization for Large Language Model Generation Inference](https://arxiv.org/abs/2303.04673).
39
+
40
+ :fire: FLAML supports Code-First AutoML & Tuning – Private Preview in [Microsoft Fabric Data Science](https://learn.microsoft.com/en-us/fabric/data-science/). -->
41
+
42
+
43
+ ## What is AutoGen
44
+
45
+ AutoGen is a framework that enables development of LLM applications using multiple agents that can converse with each other to solve tasks. AutoGen agents are customizable, conversable, and seamlessly allow human participation. They can operate in various modes that employ combinations of LLMs, human inputs, and tools.
46
+
47
+ ![AutoGen Overview](https://github.com/microsoft/autogen/blob/main/website/static/img/autogen_agentchat.png)
48
+
49
+ * AutoGen enables building next-gen LLM applications based on **multi-agent conversations** with minimal effort. It simplifies the orchestration, automation and optimization of a complex LLM workflow. It maximizes the performance of LLM models and overcomes their weaknesses.
50
+ * It supports **diverse conversation patterns** for complex workflows. With customizable and conversable agents, developers can use AutoGen to build a wide range of conversation patterns concerning conversation autonomy,
51
+ the number of agents, and agent conversation topology.
52
+ * It provides a collection of working systems with different complexities. These systems span a **wide range of applications** from various domains and complexities. This demonstrates how AutoGen can easily support diverse conversation patterns.
53
+ * AutoGen provides a drop-in replacement of `openai.Completion` or `openai.ChatCompletion` as an **enhanced inference API**. It allows easy performance tuning, utilities like API unification and caching, and advanced usage patterns, such as error handling, multi-config inference, context programming, etc.
54
+
55
+ AutoGen is powered by collaborative [research studies](https://microsoft.github.io/autogen/docs/Research) from Microsoft, Penn State University, and University of Washington.
56
+
57
+ ## Installation
58
+
59
+ AutoGen requires **Python version >= 3.8**. It can be installed from pip:
60
+
61
+ ```bash
62
+ pip install pyautogen
63
+ ```
64
+
65
+ Minimal dependencies are installed without extra options. You can install extra options based on the feature you need.
66
+ For example, use the following to install the dependencies needed by the [`blendsearch`](https://microsoft.github.io/FLAML/docs/Use-Cases/Tune-User-Defined-Function#blendsearch-economical-hyperparameter-optimization-with-blended-search-strategy) option.
67
+ ```bash
68
+ pip install "pyautogen[blendsearch]"
69
+ ```
70
+
71
+ Find more options in [Installation](https://microsoft.github.io/autogen/docs/Installation).
72
+ <!-- Each of the [`notebook examples`](https://github.com/microsoft/autogen/tree/main/notebook) may require a specific option to be installed. -->
73
+
74
+ For LLM inference configurations, check the [FAQ](https://microsoft.github.io/autogen/docs/FAQ#set-your-api-endpoints).
75
+
76
+ ## Quickstart
77
+
78
+ * Autogen enables the next-gen LLM applications with a generic multi-agent conversation framework. It offers customizable and conversable agents which integrate LLMs, tools, and humans.
79
+ By automating chat among multiple capable agents, one can easily make them collectively perform tasks autonomously or with human feedback, including tasks that require using tools via code. For [example](https://github.com/microsoft/autogen/blob/main/test/twoagent.py),
80
+ ```python
81
+ from autogen import AssistantAgent, UserProxyAgent, config_list_from_json
82
+ # Load LLM inference endpoints from an env variable or a file
83
+ # See https://microsoft.github.io/autogen/docs/FAQ#set-your-api-endpoints
84
+ # and OAI_CONFIG_LIST_sample.json
85
+ config_list = config_list_from_json(env_or_file="OAI_CONFIG_LIST")
86
+ assistant = AssistantAgent("assistant", llm_config={"config_list": config_list})
87
+ user_proxy = UserProxyAgent("user_proxy", code_execution_config={"work_dir": "coding"})
88
+ user_proxy.initiate_chat(assistant, message="Plot a chart of NVDA and TESLA stock price change YTD.")
89
+ # This initiates an automated chat between the two agents to solve the task
90
+ ```
91
+
92
+ This example can be run with
93
+ ```python
94
+ python test/twoagent.py
95
+ ```
96
+ After the repo is cloned.
97
+ The figure below shows an example conversation flow with AutoGen.
98
+ ![Agent Chat Example](https://github.com/microsoft/autogen/blob/main/website/static/img/chat_example.png)
99
+
100
+ Please find more [code examples](https://microsoft.github.io/autogen/docs/Examples/AutoGen-AgentChat) for this feature.
101
+
102
+ * Autogen also helps maximize the utility out of the expensive LLMs such as ChatGPT and GPT-4. It offers a drop-in replacement of `openai.Completion` or `openai.ChatCompletion` adding powerful functionalities like tuning, caching, error handling, and templating. For example, you can optimize generations by LLM with your own tuning data, success metrics and budgets.
103
+ ```python
104
+ # perform tuning
105
+ config, analysis = autogen.Completion.tune(
106
+ data=tune_data,
107
+ metric="success",
108
+ mode="max",
109
+ eval_func=eval_func,
110
+ inference_budget=0.05,
111
+ optimization_budget=3,
112
+ num_samples=-1,
113
+ )
114
+ # perform inference for a test instance
115
+ response = autogen.Completion.create(context=test_instance, **config)
116
+ ```
117
+
118
+ Please find more [code examples](https://microsoft.github.io/autogen/docs/Examples/AutoGen-Inference) for this feature.
119
+
120
+ ## Documentation
121
+
122
+ You can find a detailed documentation about AutoGen [here](https://microsoft.github.io/autogen/).
123
+
124
+ In addition, you can find:
125
+
126
+ - [Research](https://microsoft.github.io/autogen/docs/Research) and [blogposts](https://microsoft.github.io/autogen/blog) around AutoGen.
127
+
128
+ - [Discord](https://discord.gg/pAbnFJrkgZ).
129
+
130
+ - [Contributing guide](https://microsoft.github.io/autogen/docs/Contribute).
131
+
132
+ ## Contributing
133
+
134
+ This project welcomes contributions and suggestions. Most contributions require you to agree to a
135
+ Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
136
+ the rights to use your contribution. For details, visit <https://cla.opensource.microsoft.com>.
137
+
138
+ If you are new to GitHub [here](https://help.github.com/categories/collaborating-with-issues-and-pull-requests/) is a detailed help source on getting involved with development on GitHub.
139
+
140
+ When you submit a pull request, a CLA bot will automatically determine whether you need to provide
141
+ a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
142
+ provided by the bot. You will only need to do this once across all repos using our CLA.
143
+
144
+ This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
145
+ For more information, see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
146
+ contact [[email protected]](mailto:[email protected]) with any additional questions or comments.
147
+
148
+ # Legal Notices
149
+
150
+ Microsoft and any contributors grant you a license to the Microsoft documentation and other content
151
+ in this repository under the [Creative Commons Attribution 4.0 International Public License](https://creativecommons.org/licenses/by/4.0/legalcode),
152
+ see the [LICENSE](LICENSE) file, and grant you a license to any code in the repository under the [MIT License](https://opensource.org/licenses/MIT), see the
153
+ [LICENSE-CODE](LICENSE-CODE) file.
154
+
155
+ Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation
156
+ may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries.
157
+ The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks.
158
+ Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.
159
+
160
+ Privacy information can be found at https://privacy.microsoft.com/en-us/
161
+
162
+ Microsoft and any contributors reserve all other rights, whether under their respective copyrights, patents,
163
+ or trademarks, whether by implication, estoppel or otherwise.