https://github.com/thinkwee/iagents

connecting humans and agents
https://github.com/thinkwee/iagents

Last synced: about 1 month ago
JSON representation

connecting humans and agents

Host: GitHub
URL: https://github.com/thinkwee/iagents
Owner: thinkwee
Created: 2024-06-21T04:03:59.000Z (11 months ago)
Default Branch: main
Last Pushed: 2024-12-06T08:05:33.000Z (6 months ago)
Last Synced: 2025-04-02T07:08:02.480Z (about 2 months ago)
Language: Python
Homepage: https://thinkwee.top/iagents/
Size: 96.6 MB
Stars: 80
Watchers: 3
Forks: 9
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

## 🎆 News
* This repo has moved to https://github.com/thunlp/iAgents, Please check our latest progress there.
* 2024.10.20 The iAgents platform is free to use for everyone at iAgents Website! 🥳 You can also check our Huggingface Space!
* 2024.9.26 🎉🎉🎉 Our paper [*Autonomous Agents for Collaborative Task under Information Asymmetry*](https://arxiv.org/abs/2406.14928) is accepted by NeurIPS 2024! Also, we release the [official website](https://thinkwee.top/iagents) for **iAgents**! 🌟 The iAgents platform will be free for everyone to use (coming soon)! 🥳

* 2024.9.24 ✅ iAgents now supports more LLM backends! Now supports `deepseek`, `glm`, `hunyuan`, `ernie`, `spark` and `qwen`~

2024.9.9 ✅ We release informativeBench!

* Check out [**informativeBench**](./data/README.md)!, a meticulously crafted benchmark designed to evaluate language models and agents in information-asymmetric collaborative environments.

2024.7.23 ✅ iAgents now supports Agent Cultivate!

* 2024.7.23 ✅ iAgents now supports **Agent Cultivate**! You can now cultivate your agent by clicking on the Agent Admin Panel button and talking with your Agent. You can also use your human feedback data to automatically optimize it. The agent profile will be improved during the cultivation.

2024.7.13 ✅ iAgents now supports Jina Reader!

* 2024.7.13 ✅ iAgents now supports [Jina Reader](https://jina.ai/reader)! You can now upload files or just input a url, and jina reader will transform the webpage into a LLM-friendly text and upload it as your file!

2024.7.12 ✅ iAgents now supports Llama Index!

* 2024.7.12 ✅ iAgents now supports [Llama Index](https://docs.llamaindex.ai/en/stable/)! You can now upload files and your agent will retrieve them automatically to communicate and solve problems! Choose your favorite Huggingface Embedding Model and use Ollama local LLM for query response (support OpenAI soon). Just set your ``config/global.yaml`` like:

```yaml
agent:
use_llamaindex: True
```

You can 📃upload、🔍show and ❌delete your personal files provided to your agent. For example, ross here upload a file about emnlp papers, now your agent can ask ross's agent about the information of survey papers in emnlp (even though ross is a palaeontologist). ⚠️It is still a experimental function and we are working on it. See guide here.

2024.7.11 ✅ iAgents now supports Ollama!

* 2024.7.11 ✅ iAgents now supports [Ollama](https://ollama.com/)! You can use localhost LLM simply by [installing Ollama](https://ollama.com/) and set config to pick up your favorite LLM in ``config/global.yaml``, for example, a qwen2 7b model:

```yaml
backend:
provider: ollama
ollama_model_name: qwen2:7b
```
See guide here.

2024.7.8 ✅ iAgents now supports Docker!

* 2024.7.8 ✅ We provide the docker build for iAgents! Please refer to 🐳 Quickstart through Docker

## 📖 Overview

- **iAgents** is a platform **designed to create a world weaved by humans and agents**, where each human has a personal **agent** that can work on their behalf to cooperate with other humans' agents. It is a new paradigm for [Large Language Model-powered Multi-Agent Systems](https://thinkwee.top/multiagent_ebook/index.html). **iAgents** proactively interact with human users to exchange information, while autonomously communicating with other agents to eliminate information asymmetry and collaborate effectively to accomplish tasks ([see our paper](https://arxiv.org/abs/2406.14928)).

## ⚡️ Quickstart
- **iAgents** features an instant messaging web UI that users can utilize as a conventional chat application, with each user automatically equipped with a personal agent. Messages beginning with '@' are automatically transformed into collaborative task commands, prompting the agents of both chat participants to engage and resolve the task through autonomous communication.
- Here we have quick start guides to use **iAgents** in both shell and docker modes.

### 💻 Quickstart through Shell
1. You need to prepare:
- [Python environment of version 3.9 or higher](https://docs.anaconda.com/working-with-conda/environments/)
- [MySQL environment]()
- [OpenAI API key](https://help.openai.com/en/articles/4936850-where-do-i-find-my-openai-api-key)

2. **Clone the GitHub Repository:** Begin by cloning the repository using the command:

```
git clone https://github.com/thinkwee/iAgents.git
```

3. **Set Up Python Environment:** Ensure you have a version 3.9 or higher Python environment. You can create and activate this environment using the following commands, replacing `iAgents` with your preferred environment name:

```
conda create -n iAgents python=3.9 -y
conda activate iAgents
```

4. **Install Dependencies:** Move into the `iAgents` directory and install the necessary dependencies by running:

```
cd iAgents
pip3 install -r requirements.txt
```

5. **Set Config File:** Set your iAgents config file ``config/global.yaml`` by filling out:
- backend.openai_api_key
- mysql.username
- mysql.password

These three config options are necessary for starting **iAgents**. For the full config file, please see [here](wiki.md#configuration).
6. **Initialize Your Database:** Run the Python script to create a MySQL database for storing the messages, users, friendships, and feedback tables in **iAgents**:
```
python3 create_database.py
```

7. **Start:** Simply execute:
```
python3 app.py
```
to start the IM UI of **iAgents**. Invite your friend to register on the website, add them, and chat with them! **Add @ before your message** and see what happens!

### 🐳 Quickstart through Docker
1. Make sure you have [docker](https://www.docker.com/get-started/) installed.

2. **Clone the GitHub Repository:** Begin by cloning the repository using the command:

```
git clone https://github.com/thinkwee/iAgents.git
```

3. **Set Config File:** Set your iAgents config file ``config/global.yaml`` by filling out:
- backend.openai_api_key
- mysql.username
- mysql.password

and set your docker env config file ``.env``. **Make sure the iAgents config is consistent with docker env config**.

These three config options are necessary for starting **iAgents**. For the full config file, please see [here](wiki.md#configuration).

4. build docker container:

```
cd iAgents
docker-compose up
```

5. **Start:** now you can visit the ``localhost:5001/login`` (by default) to start the IM UI of **iAgents**. Invite your friend to register on the website, add them, and chat with them! **Add @ before your message** and see what happens!

## 🗺️ Roadmap
- **iAgents** aims to explore a new Multi-Agent paradigm, where the value of agents is attributed to their human user's information, enhancing collaborative efficiency between humans and agents in coexistent societies. Currently, iAgents is in the academic prototype stage. **⚠️ Please do not use it in production environments.** We will continuously improve the functionality of **iAgents**. Below is our current roadmap, ordered from short-term to long-term goals:

- [x] Dockerfile
- [x] Support Ollama
- [x] Support JinaReader
- [x] Support llama_index
- [x] Agent Cultivate
- [x] Agent action status bar
- [ ] Fuzzy memory
- [ ] Enable agents to proactively initiate new communication
- [ ] Edge-side model support

## 🔎 Citation

```
@inproceedings{liuautonomous,
title={Autonomous Agents for Collaborative Task under Information Asymmetry},
author={Liu, Wei and Wang, Chenxi and Wang, YiFei and Xie, Zihao and Qiu, Rennai and Dang, Yufan and Du, Zhuoyun and Chen, Weize and Yang, Cheng and Qian, Chen},
booktitle={The Thirty-eighth Annual Conference on Neural Information Processing Systems}
}
```

## ⚖️ License

- Source Code Licensing: Our project's source code is licensed under the Apache 2.0 License. This license permits the use, modification, and distribution of the code, subject to certain conditions outlined in the Apache 2.0 License.
- Data Licensing: The related data utilized in our project is licensed under CC BY-NC 4.0. This license explicitly permits non-commercial use of the data. We would like to emphasize that any models trained using these datasets should strictly adhere to the non-commercial usage restriction and should be employed exclusively for research purposes.

## 🔬 More from our Team
- We are the [ChatDev](https://github.com/OpenBMB/ChatDev) team with a research focus on Large Language Model Multi-Agent Systems from [THUNLP Lab](https://github.com/thunlp) and [OpenBMB](https://github.com/openbmb). Our research can be found [here](https://thinkwee.top/multiagent_ebook/index.html#more-works), including:
- Interaction and Communication among Agents
- Organization for Agents
- Evolution for Agents
- Multi-Agent Systems for Simulation and Task-Solving

## 📬 Contact

If you have any questions, feedback, or would like to get in touch, please feel free to reach out to us via email at [[email protected]](mailto:[email protected]), [[email protected]](mailto:[email protected]).

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/thinkwee/iagents

Awesome Lists containing this project

README