Skip to content

Commit

Permalink
Update dev version
Browse files Browse the repository at this point in the history
  • Loading branch information
ekzhu committed Oct 23, 2024
1 parent 6edbbdc commit 1e744a8
Show file tree
Hide file tree
Showing 9 changed files with 42 additions and 35 deletions.
1 change: 1 addition & 0 deletions .github/workflows/docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,7 @@ jobs:
{ ref: main, dest-dir: dev },
{ ref: "v0.4.0dev0", dest-dir: "0.4.0dev0" },
{ ref: "v0.4.0dev1", dest-dir: "0.4.0dev1" },
{ ref: "v0.4.0dev2", dest-dir: "0.4.0dev2" },
]
steps:
- name: Checkout
Expand Down
41 changes: 22 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@
# AutoGen

> [!IMPORTANT]
>
> - (10/13/24) Interested in the standard AutoGen as a prior user? Find it at the actively-maintained *AutoGen* [0.2 branch](https://github.com/microsoft/autogen/tree/0.2) and `autogen-agentchat~=0.2` PyPi package.
> - (10/02/24) [AutoGen 0.4](https://microsoft.github.io/autogen/dev) is a from-the-ground-up rewrite of AutoGen. Learn more about the history, goals and future at [this blog post](https://microsoft.github.io/autogen/blog). We’re excited to work with the community to gather feedback, refine, and improve the project before we officially release 0.4. This is a big change, so AutoGen 0.2 is still available, maintained, and developed in the [0.2 branch](https://github.com/microsoft/autogen/tree/0.2).
Expand All @@ -18,11 +19,11 @@ It simplifies the creation of event-driven, distributed, scalable, and resilient
It allows you to quickly build systems where AI agents collaborate and perform tasks autonomously
or with human oversight.

* [Key Features](#key-features)
* [API Layering](#api-layering)
* [Quickstart](#quickstart)
* [Roadmap](#roadmap)
* [FAQs](#faqs)
- [Key Features](#key-features)
- [API Layering](#api-layering)
- [Quickstart](#quickstart)
- [Roadmap](#roadmap)
- [FAQs](#faqs)

AutoGen streamlines AI development and research, enabling the use of multiple large language models (LLMs), integrated tools, and advanced multi-agent design patterns. You can develop and test your agent systems locally, then deploy to a distributed cloud environment as your needs grow.

Expand Down Expand Up @@ -100,7 +101,7 @@ We look forward to your contributions!
First install the packages:

```bash
pip install autogen-agentchat==0.4.0dev1 autogen-ext==0.4.0dev1
pip install autogen-agentchat==0.4.0dev2 autogen-ext==0.4.0dev2
```

The following code uses code execution, you need to have [Docker installed](https://docs.docker.com/engine/install/)
Expand Down Expand Up @@ -135,7 +136,8 @@ async def main() -> None:
asyncio.run(main())
```

### C#
### C #

The .NET SDK does not yet support all of the interfaces that the python SDK offers but we are working on bringing them to parity.
To use the .NET SDK, you need to add a package reference to the src in your project.
We will release nuget packages soon and will update these instructions when that happens.
Expand Down Expand Up @@ -229,13 +231,13 @@ dotnet run
## Roadmap

- AutoGen 0.2 - This is the current stable release of AutoGen. We will continue to accept bug fixes and minor enhancements to this version.
- AutoGen 0.4 - This is the first release of the new architecture. This release is still in _preview_. We will be focusing on the stability of the interfaces, documentation, tutorials, samples, and a collection of built-in agents which you can use. We are excited to work with our community to define the future of AutoGen. We are looking for feedback and contributions to help shape the future of this project. Here are some major planned items:
- More programming languages (e.g., TypeScript)
- More built-in agents and multi-agent workflows
- Deployment of distributed agents
- Re-implementation/migration of AutoGen Studio
- Integration with other agent frameworks and data sources
- Advanced RAG techniques and memory services
- AutoGen 0.4 - This is the first release of the new architecture. This release is still in *preview*. We will be focusing on the stability of the interfaces, documentation, tutorials, samples, and a collection of built-in agents which you can use. We are excited to work with our community to define the future of AutoGen. We are looking for feedback and contributions to help shape the future of this project. Here are some major planned items:
- More programming languages (e.g., TypeScript)
- More built-in agents and multi-agent workflows
- Deployment of distributed agents
- Re-implementation/migration of AutoGen Studio
- Integration with other agent frameworks and data sources
- Advanced RAG techniques and memory services

<p align="right" style="font-size: 14px; color: #555; margin-top: 20px;">
<a href="#readme-top" style="text-decoration: none; color: blue; font-weight: bold;">
Expand Down Expand Up @@ -286,7 +288,7 @@ pip install autogen-agentchat~=0.2

### Will AutoGen Studio be supported in 0.4?

Yes, this is on the [roadmap](#Roadmap).
Yes, this is on the [roadmap](#roadmap).
Our current plan is to enable an implementation of AutoGen Studio
on the AgentChat high level API which implements a set of agent functionalities
(agents, teams, etc).
Expand Down Expand Up @@ -317,18 +319,19 @@ Use GitHub [Discussions](https://github.com/microsoft/autogen/discussions) for g

### Do you use Discord for communications?

We are unable to use Discord for project discussions. Therefore, we request that all discussions take place on https://github.com/microsoft/autogen/discussions/ going forward.
We are unable to use Discord for project discussions. Therefore, we request that all discussions take place on <https://github.com/microsoft/autogen/discussions/> going forward.

### What about forks?

https://github.com/microsoft/autogen/ remains the only official repo for development and support of AutoGen.
<https://github.com/microsoft/autogen/> remains the only official repo for development and support of AutoGen.
We are aware that there are thousands of forks of AutoGen, including many for personal development and startups building with or on top of the library. We are not involved with any of these forks and are not aware of any plans related to them.

### What is the status of the license and open source?

Our project remains fully open-source and accessible to everyone. We understand that some forks use different licenses to align with different interests. We will continue to use the most permissive license (MIT) for the project.

### Can you clarify the current state of the packages?

Currently, we are unable to make releases to the `pyautogen` package via Pypi due to a change to package ownership that was done without our involvement. Additionally, we are moving to using multiple packages to align with the new design. Please see details [here](https://microsoft.github.io/autogen/dev/packages/index.html).

### Can I still be involved?
Expand All @@ -351,9 +354,9 @@ see the [LICENSE](LICENSE) file, and grant you a license to any code in the repo
Microsoft, Windows, Microsoft Azure, and/or other Microsoft products and services referenced in the documentation
may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries.
The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks.
Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.
Microsoft's general trademark guidelines can be found at <http://go.microsoft.com/fwlink/?LinkID=254653>.

Privacy information can be found at https://go.microsoft.com/fwlink/?LinkId=521839
Privacy information can be found at <https://go.microsoft.com/fwlink/?LinkId=521839>

Microsoft and any contributors reserve all other rights, whether under their respective copyrights, patents,
or trademarks, whether by implication, estoppel, or otherwise.
Expand Down
6 changes: 6 additions & 0 deletions docs/switcher.json
Original file line number Diff line number Diff line change
Expand Up @@ -18,5 +18,11 @@
"version": "0.4.0dev1",
"url": "/autogen/0.4.0dev1/",
"preferred": true
},
{
"name": "0.4.0dev2",
"version": "0.4.0dev2",
"url": "/autogen/0.4.0dev2/",
"preferred": true
}
]
4 changes: 2 additions & 2 deletions python/packages/autogen-agentchat/pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ build-backend = "hatchling.build"

[project]
name = "autogen-agentchat"
version = "0.4.0dev1"
version = "0.4.0dev2"
license = {file = "LICENSE-CODE"}
description = "AutoGen agents and teams library"
readme = "README.md"
Expand All @@ -15,7 +15,7 @@ classifiers = [
"Operating System :: OS Independent",
]
dependencies = [
"autogen-core==0.4.0dev1",
"autogen-core==0.4.0dev2",
]

[tool.uv]
Expand Down
6 changes: 2 additions & 4 deletions python/packages/autogen-core/docs/src/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,6 @@ A framework for building AI agents and multi-agent applications

<div style="margin-top: 2rem;">


::::{grid} 1 1 2 2

:::{grid-item-card}
Expand All @@ -55,15 +54,14 @@ A framework for building AI agents and multi-agent applications
{fas}`triangle-exclamation` Work in progress
</div>


<div class="sd-card-title sd-font-weight-bold docutils">

{fas}`people-group;pst-color-primary`
AgentChat </div>
High-level API that includes preset agents and teams for building multi-agent systems.

```sh
pip install autogen-agentchat==0.4.0dev1
pip install autogen-agentchat==0.4.0dev2
```

💡 *Start here if you are looking for an API similar to AutoGen 0.2*
Expand All @@ -84,7 +82,7 @@ Get Started
Provides building blocks for creating asynchronous, event driven multi-agent systems.

```sh
pip install autogen-core==0.4.0dev1
pip install autogen-core==0.4.0dev2
```

+++
Expand Down
7 changes: 3 additions & 4 deletions python/packages/autogen-core/docs/src/packages/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,10 +29,9 @@ myst:
Library that is at a similar level of abstraction as AutoGen 0.2, including default agents and group chat.

```sh
pip install autogen-agentchat==0.4.0dev1
pip install autogen-agentchat==0.4.0dev2
```


[{fas}`circle-info;pst-color-primary` User Guide](/user-guide/agentchat-user-guide/index.md) | [{fas}`file-code;pst-color-primary` API Reference](/reference/python/autogen_agentchat/autogen_agentchat.rst) | [{fab}`python;pst-color-primary` PyPI](https://pypi.org/project/autogen-agentchat/0.4.0.dev1/) | [{fab}`github;pst-color-primary` Source](https://github.com/microsoft/autogen/tree/main/python/packages/autogen-agentchat)
:::

Expand All @@ -45,7 +44,7 @@ pip install autogen-agentchat==0.4.0dev1
Implements the core functionality of the AutoGen framework, providing basic building blocks for creating multi-agent systems.

```sh
pip install autogen-core==0.4.0dev1
pip install autogen-core==0.4.0dev2
```

[{fas}`circle-info;pst-color-primary` User Guide](/user-guide/core-user-guide/index.md) | [{fas}`file-code;pst-color-primary` API Reference](/reference/python/autogen_core/autogen_core.rst) | [{fab}`python;pst-color-primary` PyPI](https://pypi.org/project/autogen-core/0.4.0.dev1/) | [{fab}`github;pst-color-primary` Source](https://github.com/microsoft/autogen/tree/main/python/packages/autogen-core)
Expand All @@ -60,7 +59,7 @@ pip install autogen-core==0.4.0dev1
Implementations of core components that interface with external services, or use extra dependencies. For example, Docker based code execution.

```sh
pip install autogen-ext==0.4.0dev1
pip install autogen-ext==0.4.0dev2
```

Extras:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -55,13 +55,13 @@ conda deactivate
``````

## Intall the AgentChat package using pip:
## Intall the AgentChat package using pip

Install the `autogen-agentchat` package using pip:

```bash

pip install autogen-agentchat==0.4.0dev1
pip install autogen-agentchat==0.4.0dev2
```

## Install Docker for Code Execution
Expand Down
2 changes: 1 addition & 1 deletion python/packages/autogen-core/pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ build-backend = "hatchling.build"

[project]
name = "autogen-core"
version = "0.4.0dev1"
version = "0.4.0dev2"
license = {file = "LICENSE-CODE"}
description = "Foundational interfaces and agent runtime implementation for AutoGen"
readme = "README.md"
Expand Down
6 changes: 3 additions & 3 deletions python/packages/autogen-ext/pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ build-backend = "hatchling.build"

[project]
name = "autogen-ext"
version = "0.4.0dev1"
version = "0.4.0dev2"
license = {file = "LICENSE-CODE"}
description = "AutoGen extensions library"
readme = "README.md"
Expand All @@ -15,7 +15,7 @@ classifiers = [
"Operating System :: OS Independent",
]
dependencies = [
"autogen-core==0.4.0dev1",
"autogen-core==0.4.0dev2",
]


Expand Down Expand Up @@ -56,4 +56,4 @@ test = "pytest -n auto"
[tool.mypy]
[[tool.mypy.overrides]]
module = "docker.*"
ignore_missing_imports = true
ignore_missing_imports = true

0 comments on commit 1e744a8

Please sign in to comment.