evo.ninja

Discord | :star: the repo !
---
Welcome!
To get started using evo.ninja simply head to our website, or to build and run from source follow these setup instructions.
Need Help?
Join our Discord community for support and discussions.
If you have questions or encounter issues, please don't hesitate to create a new issue to get support.
How it works
What makes evo.ninja special is that it adapts itself in real-time, based on the tasks at hand. Evo utilizes pre-defined agent personas that are tailored to specific domains of tasks. Each iteration of evo's execution loop it will select and adopt the persona that fits the task at hand best.
Agent Personas
| Agent | Expertise |
|-|-|
| 📝Synthesizer | "Reads text files, analyzing and gathering data and information from text files, generating summaries and reports, and analyzing text." |
| #️⃣ Csv Analyst | "Adept at reading CSV files, searching for data, extracting key data points, calculating amounts, and derive insights from CSV files." |
| 🌐 Researcher | "Searching the internet, comprehending details, and finding information." |
| 💻 Developer | "Architect and build complex software. specialized in python." |
Execution Loop
1. **Predict Next Step:** For each iteration of the execution loop, Evo starts by making an informed prediction about what the best-next-step should be.
2. **Select Best Agent:** Based on this prediction, Evo selects a best-fit agent persona.
3. **Contextualize Chat History:** Based on the prediction from step 1, and the agent persona in step 2, the complete chat history is "contextualized" and only the most relevant messages are used for the final evaluation step.
4. **Evaluate and Execute:** A final evaluation step is run to determine what agent function is executed to try and further achieve the user's goal.
These 4 steps run in a loop continuously until it is determined the user's goal has been achieved.
Setup
Pre-Requisites
Please install the following:
- git
- nodejs
- yarn
- nvm
Installation
1. Clone the repository
> git clone https://github.com/agentcoinorg/evo.ninja
2. Copy the .env.template file and rename it to .env.
> cp .env.template .env
3. Find the line that says OPENAI_API_KEY=, and add your unique OpenAI API Key
OPENAI_API_KEY=sk-...
4. Find the line that says SERP_API_KEY=, and add your unique SERP API Key.
SERP_API_KEY=b071... (see https://serpapi.com)
5. Use the correct version of Node.JS
> nvm install && nvm use
Install Yarn if the node environment is new
> npm install -g yarn
6. Install all dependencies & build project
> yarn && yarn build
Now you're ready to go! You can run Evo through CLI or using the UI
CLI
Run evo in the terminal:
> yarn start
**Arguments:**
- [goal] - Goal to be achieved
**Options:**
- -s, --session - Name of the session within the ./sessions/... directory.
- -t, --timeout - Specify a timeout, used to terminate the process after a specified number of seconds.