AgentStore: Scalable Integration of Heterogeneous Agents As Specialized Generalist Computer Assistant

[🌐 Website] • [📜 Paper] • [🤗 HF Models] •

Repo for "AgentStore: Scalable Integration of Heterogeneous Agents As Specialized Generalist Computer Assistant"

What is AgentStore

AgentStore is a flexible and scalable platform for dynamically integrating various heterogeneous agents to independently or collaboratively automate OS tasks. It allows users to quickly integrate their own specialized agents into the platform, similar to the functionality of the App store. This scalable integration allows the framework to dynamically adapt itself to the evolving OS, providing the multi-dimensional capabilities needed for open-ended tasks.

💾 Installation

Preparing the OSworld Environment

Agents in AgentStore operate within the OSworld environment; thus, a complete setup of the OSworld is required. For detailed setup instructions, please refer to the OSworld documentation. We provide a quick step-by-step installation guide for setting up the necessary environment.

1. First, clone this repository and cd into it. Then, install the dependencies listed in requirements.txt.

# Clone the OSWorld repository
git clone https://github.com/xlang-ai/OSWorld

# Change directory into the cloned repository
cd OSWorld

# Optional: Create a Conda environment for OSWorld
# conda create -n osworld python=3.9
# conda activate osworld

# Install required dependencies
pip install -r requirements.txt

2. Install VMware Workstation Pro (for systems with Apple Chips, you should install VMware Fusion) and configure the vmrun command. The installation process can refer to How to install VMware Worksation Pro. Verify the successful installation by running the following:

vmrun -T ws list

If the installation along with the environment variable set is successful, you will see the message showing the current running virtual machines.

All set! The setup script will automatically download the necessary virtual machines and configure the environment for you.

Install AgentStore

1. Clone the GitHub Repository:

   git clone [email protected]:chengyou-jia/AgentStore.git
   

2. Set Up Python Environment and Install Dependencies:

   conda create -n agentstore_env python=3.10 -y
   conda activate agentstore_env
   
   cd AgentStore
   pip install -e .
   

3. Set OpenAI API Key: Configure your OpenAI API key in .env.

   cp .env_template .env
   

⚡️ Quickstart

1. Run agents in AgentStore: (See quick_start.py for more specific configuration )

   python quick_start.py --agent_name "ChromeAgent"
   

Citation

If you find it helpful, please kindly cite the paper.

@article{jia2024agentstore,
      title={AgentStore: Scalable Integration of Heterogeneous Agents As Specialized Generalist Computer Assistant},
      author={Jia, Chengyou and Luo, Minnan and Dang, Zhuohang and Sun, Qiushi and Xu, Fangzhi and Hu, Junlin and Xie, Tianbao and Wu, Zhiyong},
      journal={arXiv preprint arXiv:2410.18603},
      year={2024}
    }

📬 Contact

If you have any inquiries, suggestions, or wish to contact us for any reason, we warmly invite you to email us at [email protected].