Skip to content

Generate different roles for GPTs to form a collaborative entity for complex tasks.

License

Notifications You must be signed in to change notification settings

DoLife/AutoAgents

 
 

Repository files navigation

AutoAgents: A Framework for Automatic Agent Generation

autoagents logo: A Framework for Automatic Agent Generation.

Generate different roles for GPTs to form a collaborative entity for complex tasks.

Paper CN doc EN doc JA doc License: MIT

AutoAgents is an experimental open-source application for an Automatic Agents Generation Experiment based on LLM. This program, driven by LLM, autonomously generates multi-agents to achieve whatever goal you set.

The execution process of AutoAgents.

  • 2023.08.30: 🚀 Adding a custom agent collection, AgentBank, allows you to add custom agents.

🚀 Features

  • Planner: Determines the expert roles to be added and the specific execution plan according to the problem.
  • Tools: The set of tools that can be used, currently only compatible with the search tools.
  • Observers: Responsible for reflecting on whether the planner and the results in the execution process are reasonable, currently including reflection checks on Agents, Plan, and Action.
  • Agents: Expert role agents generated by the planner, including name, expertise, tools used, and LLM enhancement.
  • Plan: The execution plan is composed of the generated expert roles, each step of the execution plan has at least one expert role agent.
  • Actions: The specific actions of the expert roles in the execution plan, such as calling tools or outputting results.

Demo

Online demo:

Video demo:

  • Rumor Verification
    rumor-verification.mp4
  • Gluttonous Snake
    snake-game-demo-en.mp4

Installation and Usage

Installation

git clone https://github.com/LinkSoul-AI/AutoAgents
cd AutoAgents
python setup.py install

Configuration

  • Configure your OPENAI_API_KEY in any of config/key.yaml / config/config.yaml / env
  • Priority order: config/key.yaml > config/config.yaml > env
# Copy the configuration file and make the necessary modifications.
cp config/config.yaml config/key.yaml
Variable Name config/key.yaml env
OPENAI_API_KEY # Replace with your own key OPENAI_API_KEY: "sk-..." export OPENAI_API_KEY="sk-..."
OPENAI_API_BASE # Optional OPENAI_API_BASE: "https://<YOUR_SITE>/v1" export OPENAI_API_BASE="https://<YOUR_SITE>/v1"

Usage

  • Commandline mode:
python main.py --mode commandline --llm_api_key YOUR_OPENAI_API_KEY --serpapi_key YOUR_SERPAPI_KEY --idea "Is LK-99 really a room temperature superconducting material?"
  • Websocket service mode:
python main.py --mode service --host "127.0.0.1" --port 9000

Docker

  • Build docker image:
IMAGE="linksoul.ai/autoagents"
VERSION=1.0

docker build -f docker/Dockerfile -t "${IMAGE}:${VERSION}" .
  • Start docker container:
docker run -it --rm -p 7860:7860 "${IMAGE}:${VERSION}"

Contributing

AutoAgents is dedicated to creating a cutting-edge automated multi-agent environment for large language models. We are actively seeking enthusiastic collaborators to embark with us on this thrilling and innovative journey.

This project exists thanks to all the people who contribute:

Contributor Contributor Contributor Contributor Contributor Contributor Contributor Contributor Contributor Contributor

How Can You Contribute?

  • Issue Reporting and Pull Requests: Encountering difficulties with AutoAgents? Feel free to raise the issue in English. Additionally, you're welcome to take initiative by resolving these issues yourself. Simply request to be assigned the issue, and upon resolution, submit a pull request (PR) with your solution.

  • Software Development Contributions: As an engineer, your skills can significantly enhance AutoAgents. We are in constant pursuit of skilled developers to refine, optimize, and expand our framework, enriching our feature set and devising new modules.

  • Content Creation for Documentation and Tutorials: If writing is your forte, join us in improving our documentation and developing tutorials or blog posts. Your contribution will make AutoAgents more user-friendly and accessible to a diverse audience.

  • Innovative Application Exploration: Intrigued by the prospects of multi-agent systems? If you're keen to experiment with AutoAgents, we're excited to support your endeavors and curious to see your innovative creations.

  • User Feedback and Strategic Suggestions: We highly value user input. Engage with AutoAgents and share your feedback. Your insights are crucial for ongoing enhancements, ensuring our framework's excellence and relevance.

Contact Information

If you have any questions or feedback about this project, please feel free to contact us. We highly appreciate your suggestions!

We will respond to all questions within 2-3 business days.

License

MIT license

Citation

If you find our work and this repository useful, please consider giving a star ⭐ and citation 🍺:

@article{chen2023auto,
  title={AutoAgents: The Automatic Agents Generation Framework},
  author={Chen, Guangyao and Dong, Siwei and Shu, Yu and Zhang, Ge and Jaward, Sesay and Börje, Karlsson and Fu, Jie and Shi, Yemin},
  journal={arXiv preprint},
  year={2023}
}

Wechat Group

Wechat Group

Acknowledgements

The system, action_bank and role_bank of this code base is built using MetaGPT

Icons in the framework made by Darius Dan, Freepik, kmg design, Flat Icons, Vectorslab from FlatIcon


Star History Chart

About

Generate different roles for GPTs to form a collaborative entity for complex tasks.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 54.2%
  • JavaScript 35.5%
  • HTML 4.5%
  • CSS 4.4%
  • Shell 1.1%
  • Dockerfile 0.3%