Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/corca-ai/EVAL
EVAL(Elastic Versatile Agent with Langchain) will execute all your requests. Just like an eval method!
https://github.com/corca-ai/EVAL
Last synced: 3 months ago
JSON representation
EVAL(Elastic Versatile Agent with Langchain) will execute all your requests. Just like an eval method!
- Host: GitHub
- URL: https://github.com/corca-ai/EVAL
- Owner: corca-ai
- License: mit
- Created: 2023-03-17T15:41:29.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-05-30T05:02:09.000Z (over 1 year ago)
- Last Synced: 2024-08-02T16:45:33.750Z (6 months ago)
- Language: Python
- Homepage:
- Size: 2.1 MB
- Stars: 864
- Watchers: 29
- Forks: 81
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-langchain-zh - EVAL - ai/EVAL?style=social): 具有Langchain的弹性多功能代理。将执行您的所有请求。 (工具 / 服务)
- awesome-langchain - EVAL - ai/EVAL?style=social) (Tools / Services)
README
# EVAL
> **EVAL(Elastic Versatile Agent with Langchain) will execute all your requests. Like the eval method!**
>
> You don't have to think about how. If you tell them the results you want, they'll search, code, run, and test the Internet themselves, and they'll return the final results.
https://user-images.githubusercontent.com/19206046/229892113-481437b7-a332-4e0c-bfb3-d2c97c9035be.mp4
EVAL Making a full-fledged web application with multiple files
https://user-images.githubusercontent.com/51526347/230061897-b3479405-8ebd-45ab-a432-6506730242b9.mov
EVAL Making a UI for itself
#### [EVAL-BOT](https://github.com/eval-bot)
EVAL's self-managed github account. EVAL does everything except for signup and bio setting.
### Examples
[Here](examples/) is an example.
### EVAL's FEATURE
1. **Multimodal Conversation**
- It **understands** and **generates** data formats for text, image, dataframe, audio (TODO), video (TODO).
2. **Services**
- It can serve **services (blocking processes)** such as web apps.
3. **Evolving**
- It can **create it's own tools** by writing, modifying, executing and testing code.
### BUILT-IN TOOLS
1. Terminal
- SyscallTracer
2. Code Editor
- READ: Read and understand file.
- WRITE: Write code to create a new tool.
- PATCH: Correct the error throught the code patch if an error occurs.
- DELETE: Delete code in file for a new start.
3. Search
- Google, Bing, Wikipedia
- Custom DB Search (Currently using Corca's Wine Data in https://www.workershop.kr/en)
- Use GPT index to quickly find the information you need in a document and use that information to answer
- Requests.get (Get information from anywhere you want)
4. Image Understanding, Generation, Editing
- Image Understanding
- Image Understanding: blip-image-captioning
- Visual Question&Answering: blip-vqa
- Image Generation: Stable Diffusion 1.5
- Image Editing
- Replace or remove an object: Stable Diffusion Inpainting
- Change Image's style: InstructPix2Pix
Thanks to [LangChain](https://github.com/hwchase17/langchain), [Visual ChatGPT](https://github.com/microsoft/visual-chatgpt), [llama index](https://github.com/jerryjliu/llama_index).
### CUSTOM TOOLS
We also don't know what tools EVAL will create. Every day, It will create the right tools to execute your request.
---
## Usage
1. Environment variables
2. Run with docker-compose
3. Send request to EVAL
### 1. Environment Variables
You need to write some environment variables in the `.env` file. Refer [.env.example](.env.example) if you don't know how to format it.
**Mandatory**
Manatory envs are required in order to serve EVAL.
- `OPENAI_API_KEY` - OpenAI api key
**Optional**
Each optional env has default value, so you don't need to set unless you want to change it.
- `EVAL_PORT` - port (default: 8000)
- `SERVER` - server address (default: http://localhost:8000)
- `LOG_LEVEL` - INFO | DEBUG (default: INFO)
- `BOT_NAME` - give it a name! (default: Orca)
- `MODEL_NAME` - model name for GPT (default: gpt-4)
**For More Tools**
Some tools requires environment variables. Set envs depend on which tools you want to use.
- Google search tool
- `SERPAPI_API_KEY`
- Bing search tool
- `BING_SEARCH_URL`
- `BING_SUBSCRIPTION_KEY`
### 2. Run with docker-compose
- There are 2 services in docker-compose.yml
- `eval` - without GPU, much lighter
```bash
docker-compose up --build eval
```
- `eval.gpu` - with GPU, for multi-modal conversation
```bash
docker-compose up --build eval.gpu
```
- The one with GPU is much heavier and unstable for now because of the massive dependencies. We recommend you to use the one without GPU if you don't need multi-modal conversation.
### 3. Send request to EVAL
- Use the Web GUI to use EVAL in ease
- Go to `http://localhost:8000` in your browser
- Or you can manually send request to EVAL with APIs.
- `POST /api/execute`
- `session` - session id
- `files` - urls of file inputs
- `prompt` - prompt
- examples
```bash
curl -X POST -H "Content-Type: application/json" -d '{"session": "sessionid", "files": [], "prompt": "Hi there!"}' http://localhost:8000/api/execute
```
```bash
http POST http://localhost:8000/api/execute session=sessionid files:='[]' prompt="Hi there!"
```
- It also supports asynchronous execution. You can use `POST /api/execute/async` instead of `POST /api/execute`, with same body.
- It returns `id` of the execution. Use `GET /api/execute/async/{id}` to get the result.
## TODO
- [ ] GUI
- [ ] memory saving
- [ ] session manage
- [ ] convert to alpaca
- [ ] prompt upgrade
- [ ] give a tool to create tools
- [ ] etc.
## Reference
Thanks to the following repositories.
- https://github.com/hwchase17/langchain
- https://github.com/microsoft/visual-chatgpt
- https://github.com/jerryjliu/llama_index