ag2 0.7.4b1__tar.gz → 0.7.5__tar.gz

ag2-0.7.5/PKG-INFO

@@ -0,0 +1,416 @@
+Metadata-Version: 2.1
+Name: ag2
+Version: 0.7.5
+Summary: Alias package for pyautogen
+Home-page: https://github.com/ag2ai/ag2
+Author: Chi Wang & Qingyun Wu
+Author-email: support@ag2.ai
+License: Apache Software License 2.0
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9,<3.14
+Description-Content-Type: text/markdown
+Provides-Extra: flaml
+Provides-Extra: jupyter-executor
+Provides-Extra: retrievechat
+Provides-Extra: retrievechat-pgvector
+Provides-Extra: retrievechat-mongodb
+Provides-Extra: retrievechat-qdrant
+Provides-Extra: retrievechat-couchbase
+Provides-Extra: graph-rag-falkor-db
+Provides-Extra: rag
+Provides-Extra: crawl4ai
+Provides-Extra: browser-use
+Provides-Extra: neo4j
+Provides-Extra: twilio
+Provides-Extra: interop-crewai
+Provides-Extra: interop-langchain
+Provides-Extra: interop-pydantic-ai
+Provides-Extra: interop
+Provides-Extra: autobuild
+Provides-Extra: blendsearch
+Provides-Extra: mathchat
+Provides-Extra: captainagent
+Provides-Extra: teachable
+Provides-Extra: lmm
+Provides-Extra: graph
+Provides-Extra: gemini
+Provides-Extra: together
+Provides-Extra: websurfer
+Provides-Extra: redis
+Provides-Extra: cosmosdb
+Provides-Extra: websockets
+Provides-Extra: long-context
+Provides-Extra: anthropic
+Provides-Extra: cerebras
+Provides-Extra: mistral
+Provides-Extra: groq
+Provides-Extra: cohere
+Provides-Extra: ollama
+Provides-Extra: bedrock
+Provides-Extra: commsagent-discord
+Provides-Extra: commsagent-slack
+Provides-Extra: commsagent-telegram
+Provides-Extra: test
+Provides-Extra: docs
+Provides-Extra: types
+Provides-Extra: lint
+Provides-Extra: dev
+License-File: LICENSE
+License-File: NOTICE.md
+
+<a name="readme-top"></a>
+
+<p align="center">
+  <!-- The image URL points to the GitHub-hosted content, ensuring it displays correctly on the PyPI website.-->
+  <img src="https://raw.githubusercontent.com/ag2ai/ag2/27b37494a6f72b1f8050f6bd7be9a7ff232cf749/website/static/img/ag2.svg" width="150" title="hover text">
+  <br>
+  <br>
+  <img src="https://img.shields.io/pypi/dm/pyautogen?label=PyPI%20downloads">
+  <a href="https://badge.fury.io/py/autogen"><img src="https://badge.fury.io/py/autogen.svg"></a>
+  <a href="https://github.com/ag2ai/ag2/actions/workflows/python-package.yml">
+    <img src="https://github.com/ag2ai/ag2/actions/workflows/python-package.yml/badge.svg">
+  </a>
+  <img src="https://img.shields.io/badge/3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-blue">
+  <a href="https://discord.gg/pAbnFJrkgZ">
+    <img src="https://img.shields.io/discord/1153072414184452236?logo=discord&style=flat">
+  </a>
+  <a href="https://x.com/ag2oss">
+    <img src="https://img.shields.io/twitter/url/https/twitter.com/cloudposse.svg?style=social&label=Follow%20%40ag2ai">
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://docs.ag2.ai/">📚 Documentation</a> |
+  <a href="https://github.com/ag2ai/build-with-ag2">💡 Examples</a> |
+  <a href="https://docs.ag2.ai/docs/contributor-guide/contributing">🤝 Contributing</a> |
+  <a href="#related-papers">📝 Cite paper</a> |
+  <a href="https://discord.gg/pAbnFJrkgZ">💬 Join Discord</a>
+</p>
+
+<p align="center">
+AG2 was evolved from AutoGen. Fully open-sourced. We invite collaborators from all organizations to contribute.
+</p>
+
+# AG2: Open-Source AgentOS for AI Agents
+
+AG2 (formerly AutoGen) is an open-source programming framework for building AI agents and facilitating cooperation among multiple agents to solve tasks. AG2 aims to streamline the development and research of agentic AI. It offers features such as agents capable of interacting with each other, facilitates the use of various large language models (LLMs) and tool use support, autonomous and human-in-the-loop workflows, and multi-agent conversation patterns.
+
+The project is currently maintained by a [dynamic group of volunteers](MAINTAINERS.md) from several organizations. Contact project administrators Chi Wang and Qingyun Wu via [support@ag2.ai](mailto:support@ag2.ai) if you are interested in becoming a maintainer.
+
+## Table of contents
+
+- [AG2: Open-Source AgentOS for AI Agents](#ag2-open-source-agentos-for-ai-agents)
+  - [Table of contents](#table-of-contents)
+  - [Getting started](#getting-started)
+    - [Installation](#installation)
+    - [Setup your API keys](#setup-your-api-keys)
+    - [Run your first agent](#run-your-first-agent)
+  - [Example applications](#example-applications)
+  - [Introduction of different agent concepts](#introduction-of-different-agent-concepts)
+    - [Conversable agent](#conversable-agent)
+    - [Human in the loop](#human-in-the-loop)
+    - [Orchestrating multiple agents](#orchestrating-multiple-agents)
+    - [Tools](#tools)
+    - [Advanced agentic design patterns](#advanced-agentic-design-patterns)
+  - [Announcements](#announcements)
+  - [Contributors Wall](#contributors-wall)
+  - [Code style and linting](#code-style-and-linting)
+  - [Related papers](#related-papers)
+  - [Cite the project](#cite-the-project)
+  - [License](#license)
+
+## Getting started
+
+For a step-by-step walk through of AG2 concepts and code, see [Basic Concepts](https://docs.ag2.ai/docs/user-guide/basic-concepts) in our documentation.
+
+### Installation
+
+AG2 requires **Python version >= 3.9, < 3.14**. AG2 is available via `ag2` (or its alias `pyautogen` or `autogen`) on PyPI.
+
+```bash
+pip install ag2
+```
+
+Minimal dependencies are installed by default. You can install extra options based on the features you need.
+
+### Setup your API keys
+
+To keep your LLM dependencies neat we recommend using the `OAI_CONFIG_LIST` file to store your API keys.
+
+You can use the sample file `OAI_CONFIG_LIST_sample` as a template.
+
+```json
+[
+  {
+    "model": "gpt-4o",
+    "api_key": "<your OpenAI API key here>"
+  }
+]
+```
+
+### Run your first agent
+
+Create a script or a Jupyter Notebook and run your first agent.
+
+```python
+from autogen import AssistantAgent, UserProxyAgent, config_list_from_json
+
+llm_config = {
+    "config_list": config_list_from_json(env_or_file="OAI_CONFIG_LIST")
+}
+
+assistant = AssistantAgent("assistant", llm_config=llm_config)
+user_proxy = UserProxyAgent("user_proxy", code_execution_config={"work_dir": "coding", "use_docker": False})
+user_proxy.initiate_chat(assistant, message="Plot a chart of NVDA and TESLA stock price change YTD.")
+# This initiates an automated chat between the two agents to solve the task
+```
+
+## Example applications
+
+We maintain a dedicated repository with a wide range of applications to help you get started with various use cases or check out our collection of jupyter notebooks as a starting point.
+
+- [Build with AG2](https://github.com/ag2ai/build-with-ag2)
+- [Jupyter Notebooks](notebook)
+
+## Introduction of different agent concepts
+
+We have several agent concepts in AG2 to help you build your AI agents. We introduce the most common ones here.
+
+- **Conversable Agent**: Agents that are able to send messages, receive messages and generate replies using GenAI models, non-GenAI tools, or human inputs.
+- **Human in the loop**: Add human input to the conversation
+- **Orchestrating multiple agents**: Users can orchestrate multiple agents with built-in conversation patterns such as swarms, group chats, nested chats, sequential chats or customize the orchestration by registering custom reply methods.
+- **Tools**: Programs that can be registered, invoked and executed by agents
+- **Advanced Concepts**: AG2 supports more concepts such as structured outputs, rag, code execution, etc.
+
+### Conversable agent
+
+The conversable agent is the most used agent and is created for generating conversations among agents.
+It serves as a base class for all agents in AG2.
+
+```python
+from autogen import ConversableAgent
+
+# Create an AI agent
+assistant = ConversableAgent(
+    name="assistant",
+    system_message="You are an assistant that responds concisely.",
+    llm_config=llm_config
+)
+
+# Create another AI agent
+fact_checker = ConversableAgent(
+    name="fact_checker",
+    system_message="You are a fact-checking assistant.",
+    llm_config=llm_config
+)
+
+# Start the conversation
+assistant.initiate_chat(
+    recipient=fact_checker,
+    message="What is AG2?",
+    max_turns=2
+)
+```
+
+### Human in the loop
+
+Sometimes your wished workflow requires human input. Therefore you can enable the human in the loop feature.
+
+If you set `human_input_mode` to `ALWAYS` on ConversableAgent you can give human input to the conversation.
+
+There are three modes for `human_input_mode`: `ALWAYS`, `NEVER`, `TERMINATE`.
+
+We created a class which sets the `human_input_mode` to `ALWAYS` for you. Its called `UserProxyAgent`.
+
+```python
+from autogen import ConversableAgent
+
+# Create an AI agent
+assistant = ConversableAgent(
+    name="assistant",
+    system_message="You are a helpful assistant.",
+    llm_config=llm_config
+)
+
+# Create a human agent with manual input mode
+human = ConversableAgent(
+    name="human",
+    human_input_mode="ALWAYS"
+)
+# or
+human = UserProxyAgent(name="human", code_execution_config={"work_dir": "coding", "use_docker": False})
+
+# Start the chat
+human.initiate_chat(
+    recipient=assistant,
+    message="Hello! What's 2 + 2?"
+)
+
+```
+
+### Orchestrating multiple agents
+
+Users can define their own orchestration patterns using the flexible programming interface from AG2.
+
+Additionally AG2 provides multiple built-in patterns to orchestrate multiple agents, such as `GroupChat` and `Swarm`.
+
+Both concepts are used to orchestrate multiple agents to solve a task.
+
+The group chat works like a chat where each registered agent can participate in the conversation.
+
+```python
+from autogen import ConversableAgent, GroupChat, GroupChatManager
+
+# Create AI agents
+teacher = ConversableAgent(name="teacher", system_message="You suggest lesson topics.")
+planner = ConversableAgent(name="planner", system_message="You create lesson plans.")
+reviewer = ConversableAgent(name="reviewer", system_message="You review lesson plans.")
+
+# Create GroupChat
+groupchat = GroupChat(agents=[teacher, planner, reviewer], speaker_selection_method="auto")
+
+# Create the GroupChatManager, it will manage the conversation and uses an LLM to select the next agent
+manager = GroupChatManager(name="manager", groupchat=groupchat)
+
+# Start the conversation
+teacher.initiate_chat(manager, "Create a lesson on photosynthesis.")
+```
+
+The swarm requires a more rigid structure and the flow needs to be defined with hand-off, post-tool, and post-work transitions from an agent to another agent.
+
+Read more about it in the [documentation](https://docs.ag2.ai/docs/user-guide/advanced-concepts/conversation-patterns-deep-dive)
+
+### Tools
+
+Agents gain significant utility through tools as they provide access to external data, APIs, and functionality.
+
+```python
+from datetime import datetime
+from typing import Annotated
+
+from autogen import ConversableAgent, register_function
+
+# 1. Our tool, returns the day of the week for a given date
+def get_weekday(date_string: Annotated[str, "Format: YYYY-MM-DD"]) -> str:
+    date = datetime.strptime(date_string, "%Y-%m-%d")
+    return date.strftime("%A")
+
+# 2. Agent for determining whether to run the tool
+date_agent = ConversableAgent(
+    name="date_agent",
+    system_message="You get the day of the week for a given date.",
+    llm_config=llm_config,
+)
+
+# 3. And an agent for executing the tool
+executor_agent = ConversableAgent(
+    name="executor_agent",
+    human_input_mode="NEVER",
+)
+
+# 4. Registers the tool with the agents, the description will be used by the LLM
+register_function(
+    get_weekday,
+    caller=date_agent,
+    executor=executor_agent,
+    description="Get the day of the week for a given date",
+)
+
+# 5. Two-way chat ensures the executor agent follows the suggesting agent
+chat_result = executor_agent.initiate_chat(
+    recipient=date_agent,
+    message="I was born on the 25th of March 1995, what day was it?",
+    max_turns=1,
+)
+```
+
+### Advanced agentic design patterns
+
+AG2 supports more advanced concepts to help you build your AI agent workflows. You can find more information in the documentation.
+
+- [Structured Output](https://docs.ag2.ai/docs/user-guide/basic-concepts/structured-outputs)
+- [Ending a conversation](https://docs.ag2.ai/docs/user-guide/basic-concepts/ending-a-chat)
+- [Retrieval Augmented Generation (RAG)](https://docs.ag2.ai/docs/user-guide/advanced-concepts/rag)
+- [Code Execution](https://docs.ag2.ai/docs/user-guide/advanced-concepts/code-execution)
+- [Tools with Secrets](https://docs.ag2.ai/docs/user-guide/advanced-concepts/tools-with-secrets)
+
+## Announcements
+
+🔥 🎉 **Nov 11, 2024:** We are evolving AutoGen into **AG2**!
+A new organization [AG2AI](https://github.com/ag2ai) is created to host the development of AG2 and related projects with open governance. Check [AG2's new look](https://ag2.ai/).
+
+📄 **License:**
+We adopt the Apache 2.0 license from v0.3. This enhances our commitment to open-source collaboration while providing additional protections for contributors and users alike.
+
+🎉 May 29, 2024: DeepLearning.ai launched a new short course [AI Agentic Design Patterns with AutoGen](https://www.deeplearning.ai/short-courses/ai-agentic-design-patterns-with-autogen), made in collaboration with Microsoft and Penn State University, and taught by AutoGen creators [Chi Wang](https://github.com/sonichi) and [Qingyun Wu](https://github.com/qingyun-wu).
+
+🎉 May 24, 2024: Foundation Capital published an article on [Forbes: The Promise of Multi-Agent AI](https://www.forbes.com/sites/joannechen/2024/05/24/the-promise-of-multi-agent-ai/?sh=2c1e4f454d97) and a video [AI in the Real World Episode 2: Exploring Multi-Agent AI and AutoGen with Chi Wang](https://www.youtube.com/watch?v=RLwyXRVvlNk).
+
+🎉 Apr 17, 2024: Andrew Ng cited AutoGen in [The Batch newsletter](https://www.deeplearning.ai/the-batch/issue-245/) and [What's next for AI agentic workflows](https://youtu.be/sal78ACtGTc?si=JduUzN_1kDnMq0vF) at Sequoia Capital's AI Ascent (Mar 26).
+
+[More Announcements](announcements.md)
+
+## Contributors Wall
+
+<a href="https://github.com/ag2ai/ag2/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=ag2ai/ag2&max=204" />
+</a>
+
+## Code style and linting
+
+This project uses pre-commit hooks to maintain code quality. Before contributing:
+
+1. Install pre-commit:
+
+```bash
+pip install pre-commit
+pre-commit install
+```
+
+2. The hooks will run automatically on commit, or you can run them manually:
+
+```bash
+pre-commit run --all-files
+```
+
+## Related papers
+
+- [AutoGen: Enabling Next-Gen LLM Applications via Multi-Agent Conversation](https://arxiv.org/abs/2308.08155)
+
+- [EcoOptiGen: Hyperparameter Optimization for Large Language Model Generation Inference](https://arxiv.org/abs/2303.04673)
+
+- [MathChat: Converse to Tackle Challenging Math Problems with LLM Agents](https://arxiv.org/abs/2306.01337)
+
+- [AgentOptimizer: Offline Training of Language Model Agents with Functions as Learnable Weights](https://arxiv.org/pdf/2402.11359)
+
+- [StateFlow: Enhancing LLM Task-Solving through State-Driven Workflows](https://arxiv.org/abs/2403.11322)
+
+## Cite the project
+
+```
+@software{AG2_2024,
+author = {Chi Wang and Qingyun Wu and the AG2 Community},
+title = {AG2: Open-Source AgentOS for AI Agents},
+year = {2024},
+url = {https://github.com/ag2ai/ag2},
+note = {Available at https://docs.ag2.ai/},
+version = {latest}
+}
+```
+
+## License
+
+This project is licensed under the [Apache License, Version 2.0 (Apache-2.0)](./LICENSE).
+
+This project is a spin-off of [AutoGen](https://github.com/microsoft/autogen) and contains code under two licenses:
+
+- The original code from https://github.com/microsoft/autogen is licensed under the MIT License. See the [LICENSE_original_MIT](./license_original/LICENSE_original_MIT) file for details.
+
+- Modifications and additions made in this fork are licensed under the Apache License, Version 2.0. See the [LICENSE](./LICENSE) file for the full license text.
+
+We have documented these changes for clarity and to ensure transparency with our user and contributor community. For more details, please see the [NOTICE](./NOTICE.md) file.
+
+