evo.ninja

Discord | Website Give this repo a star if you use it! ⭐

Welcome to evo.ninja

The AI that evolves in real-time.

It executes scripts to achieve a goal. It is capable of using fuzzy search to find and execute any script in its library. Scripts are namespaced JavaScript functions with typed arguments and a description. If it can not find a script, it will write one itself.

Dive in to explore the capabilities and features provided by this agent. Before you can run evo.ninja, ensure you have Node.js and yarn installed.

Examples

Create one piece of SVG art and save it as art.svg
Divide 590 by 204 and save it to a file named output.txt
Create a CSV file named output.txt with the numbers from 1 to 10 and verify the content
Write the word Washington to the file called output.txt
Calculate the (590 * 204) + (1000 / 2) - 42
Fetch the price of ethereum, bitcoin and dogecoin and save them in a file named crypto.csv

Getting Started

Pre-Requisites

Please install the following:

Setup

Clone the repository git clone https://github.com/polywrap/evo.ninja
Copy the .env.template file and rename it to .env cp .env.template .env
Find the line that says OPENAI_API_KEY=, and add your unique OpenAI API Key OPENAI_API_KEY=sk-...
Use the correct version of Node.JS nvm install && nvm use
Install all dependencies yarn install
Build all packages yarn build
Run evo.ninja! yarn start

Optional: You can also pass a goal on startup: yarn start '<your main goal here>'

NOTE: Please remember that this is a prototype. Its main purpose is to demonstrate how agent can self-learn.

Workspace

Once evo.ninja is run, there will be a ./workspace directory created. This is the root directory for the agent. Any files will be read & written from this directory.

Debugging

evo.ninja keeps an up-to-date version of all messages being sent to the OpenAI API in the ./workspace/.msgs file. All of these messages will be sent to OpenAI on each chat completion. This is useful because as the message log grows, summarizations are performed upon the message history to fit them within a maximum context window token limit.

Collaborating

We are eager to work with the community to continue improving this agent, and building more wraps. If you're interested in contributing, we welcome pull-requests! Here are some ways you can contribute:

Bug Fixes: If you spot a bug or an error, feel free to fix it and submit a PR. Please include a description of the bug and how your code fixes it.
Feature Additions: We are open to new features! If you have an idea, please share it on our discord, or make an issue in this repo.
Documentation: Good documentation makes for a good project. If you spot areas in our docs that can be improved, or if something is not documented and should be, feel free to make these changes.

Remember, the best way to submit these changes is via a pull-request. If you're new to Github, you can learn about PRs here.

Also, please feel free to join our discord and discuss your ideas or ask any questions. We are an open, welcoming community and we'd love to hear from you!

Benchmarks

In order to run Agent Protocol Benchmarks you must have all pre-requisites mentioned above, as well as:

If you haven't fetched the submodules you can do it by doing the command:

git submodule update --init

Then, in one terminal you must start the Agent Protocol HTTP Server: AGENT_WORKSPACE="../../workspace" yarn start:api; in another terminal you must go to benchmarks folder and run:

poetry shell

poetry install

agbenchmark start --cutoff=300

This will run the agbenchmark framework against the API of the Agent Protocol. And will set a timeout of 5 minutes per task; if you'd like to run just one test in particular you can just add the flag --test=TestCaseName

go-xoxo/evo.ninja