Home

Awesome

<div align="center"> <img src="docs/_static/image/aoe-logo.svg" width="250"/>

PyPI Docker Image Version (tag latest semver) GitHub commit activity PyPI - Downloads

English | 简体中文

</div>

Latest Progress 🎉

Introduction

What is OpenAOE?

AOE, an acronym from DOTA2 for Area Of Effect, denotes an ability that can affect a group of targets within a certain area. Here, AOE in AI implies that user can obtain parallel outputs from multiple LLMs with one single prompt at the same time.

What problem does OpenAOE want to solve?

Currently, there are many open-source frameworks based on the ChatGPT for chat, but the LGC(LLM Group Chat) framework is still not coming yet.

The emergence of OpenAOE fills this gap: OpenAOE can help LLM researchers, evaluators, engineering developers, and even non-professionals to quickly access the market's well-known commercial and open-source LLMs, providing both single model serial response mode and multi-models parallel response mode.

What can you get from OpenAOE?

OpenAOE can:

  1. return one or more LLMs' answers at the same time by a single prompt.
  2. provide access to commercial LLM APIs, with default support for gpt3.5, gpt4, Google Palm, Minimax, Claude, Spark, etc., and also support user-defined access to other large model APIs. (API keys need to be prepared in advanced)
  3. provide access to open-source LLM APIs. ( We recommend to use LMDeploy to deploy with one click)
  4. provide backend APIs and a WEB-UI to meet the needs of different requirements.

Quick Run

[!TIP] Require python >= 3.9

We provide three different ways to run OpenAOE: run by pip， run by docker and run by source code as well.

Run by pip

Install

pip install -U openaoe

Start

openaoe -f /path/to/your/config-template.yaml

Run by docker

Install

There are two ways to get the OpenAOE docker image by:

  1. pull the OpenAOE docker image
docker pull opensealion/openaoe:latest
  1. or build a docker image
git clone https://github.com/internlm/OpenAOE
cd OpenAOE
docker build . -f docker/Dockerfile -t opensealion/openaoe:latest

Start

docker run -p 10099:10099 -v /path/to/your/config-template.yaml:/app/config.yaml --name OpenAOE opensealion/openaoe:latest

Run by source code

Install

  1. clone this project
git clone https://github.com/internlm/OpenAOE
  1. [optional] build the frontend project when the frontend codes are changed
cd OpenAOE/openaoe/frontend
npm install
npm run build

Start

cd OpenAOE # this OpenAOE is the clone directory
pip install -r openaoe/backend/requirements.txt
python -m openaoe.main -f /path/to/your/config-template.yaml

[!TIP] /path/to/your/config-template.yaml is a configuration file loaded by OpenAOE at startup, which contains the relevant configuration information for the LLMs, including: API URLs, AKSKs, Tokens, etc. A template configuration yaml file can be found in openaoe/backend/config/config-template.yaml. Note that, this config-template.yaml DOES NOT contain any API access data, you should add them by yourself.

Tech Report

You are always welcome to fork this project to contribute your work and find the TODOs in furture.

If you want to add more LLMs' APIs or features based on OpenAOE, the following info might be helpful.

Tech Stack

The technology stack we use includes:

  1. Backend framework based on python + fastapi;
  2. Frontend framework based on typescript + Sealion-Client (encapsulated based on React) + Sealion-UI.
  3. Build tools:
    1. conda: quickly create a virtual python env to install necessary packages
    2. npm: build the frontend project

[!TIP] The build tools can be installed quickly by pip install -U sealion-cli

Organization of the Repo

How to add a new model

Frontend