ai-legion - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #ai #llm #go #android #rust #linux #docker #nodejs #pytorch #security #mcp #openai

ai-legion

(★ 1,433)

An LLM-powered autonomous agent platform

File Explorer

Download Latest Version (.zip)

- - ci.yml
- - memory
- - memory
- - memory
- - memory
- GPT-Legion_A_Symphony_of_Autonomous_Endeavor.txt
- - index.ts
  - memory.ts
- - action-definition.ts
  - define-module.ts
  - index.ts
  - module-instance.ts
  - module-manager.ts
  - util.ts
- - file-store.ts
  - in-memory-store.ts
  - index.ts
  - json-store.ts
- action-handler.ts
- agent.ts
- console.ts
- in-memory-message-bus.ts
- main.ts
- make-decision.ts
- message-bus.ts
- message.ts
- openai.ts
- parameters.ts
- parse-action.test.ts
- parse-action.ts
- redis-message-bus.ts
- task-queue.test.ts
- task-queue.ts
- types.ts
- util.ts
- web-socket-server.ts
.env.template
.eslintrc.js
.gitignore
.prettierrc
jest.config.js
LICENSE
model-registry.json
package-lock.json
package.json
README.md
tsconfig.json

# Installation Guide

1. Get the code

git clone https://github.com/eumemic/ai-legion

Downloads the entire project code from GitHub to your computer.

cd ai-legion

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install

Downloads and installs the libraries listed in package.json.

npm run start [# of agents] [gpt-3.5-turbo|gpt-4]

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AI Legion: an LLM-powered autonomous agent platform

A framework for autonomous agents who can work together to accomplish tasks.

[![Discord](https://img.shields.io/discord/1095770840173383802?label=discord)](https://discord.gg/X9MkUEsEUC)

## Setup

You will need at least Node 10.

```
npm install
```

Rename the `.env.template` file at the root of the project to `.env` and add your secrets to it:

```
OPENAI_API_KEY=... # obtain from https://platform.openai.com/account/api-keys
# the following are needed for the agent to be able to search the web:
GOOGLE_SEARCH_ENGINE_ID=... # create a custom search engine at https://cse.google.com/cse/all
GOOGLE_API_KEY=... # obtain from https://console.cloud.google.com/apis/credentials
AGENT_DELAY=... # optionally, a delay in milliseconds following every agent action
```

You'll also need to enable the Google Custom Search API for your Google Cloud account, e.g. <https://console.cloud.google.com/apis/library/customsearch.googleapis.com>

## Running

Start the program:

```
npm run start [# of agents] [gpt-3.5-turbo|gpt-4]
```

Interact with the agents through the console. Anything you type will be sent as a message to all agents currently.

## Action errors

After spinning up a new agent, you will often see them make some mistakes which generate errors:

- Trying to use an action before they've asked for `help` on it to know what its parameters are
- Trying to just use a raw text response instead of a correctly-formatted action (or raw text wrapping a code block which contains a valid action)
- Trying to use a multi-line parameter value without wrapping it in the multiline delimiter (`% ff9d7713-0bb0-40d4-823c-5a66de48761b`)

This is a normal period of adjustment as they learn to operate themselves. They generally will learn from these mistakes and recover, although `gpt-3.5-turbo` agents sometimes devolve into endless error loops and can't figure out what the problem is. It's highly advised never to leave an agent unattended, since such infinite loops can eat through your tokens quickly (especially if they're stuck on a high-token-count action such as `writeFile`).

## Agent state

Each agent stores its state under the `.store` directory. Agent 1, for example, has

```
.store/1/memory
.store/1/goals
.store/1/notes
```

You can simply delete any of these things, or the whole agent folder (or the whole `.store`) to selectively wipe whatever state you want between runs. Otherwise, agents will pick up where you left off on restart.

A nice aspect of this is that when you want to debug a problem you ran into with a particular agent, you can delete the events in their memory subsequent to the point where the problem occurred, make changes to the code, and restart them to effectively replay that moment until you've fixed the bug. You can also ask an agent to implement a feature, and once they've done so you can restart, tell them that you've loaded the feature, and ask them to try it out.