Home

⚠️ Note: This doesn't work without Eden secrets yet. A localhost-ready version of Eve is expected in the future.

Prerequisites

Install Rye for Python & package management

Install homebrew

Install the following homebrew packages:

brew install libmagic
brew install ffmpeg

Set up the workflows repo:

git clone https://github.com/edenartlab/workflows.git
cd workflows

Clone Eve (in the same parent directory as workflows) and install packages:

git clone https://github.com/edenartlab/eve.git
cd eve
rye sync

Copy .env.example, name it .env.STAGE, and fill in with appropriate secret values

Quick Start

Note: All commands should be prefixed by rye run when using rye build.

To get help with eve, run:

eve --help

Create with tools

eve tool run flux_schnell --prompt "universe in a bottle" --aspect_ratio "16:9" --lora "6771cb755516ab6933fc6baa"

Upload tool config to stage (to target prod, add --db prod:

eve tool update txt2img img2vid vid2vid_sdxl

Test a tool on stage (using tool's test.json)

eve tool test flux_schnell

Chat with an agent (e.g. banny). Default is eve.

eve chat banny

Agent folder structure

An agent in the agents folder should have the following structure:

• `.env to define its secrets

Running Agents

rye run eve start [AGENT] will launch clients based on what you've specified in the clients section of your yaml, ie

To start the agent, run this command:

rye run eve start [AGENT_NAME] --platforms=discord,telegram,... --local

Note that by default, eve start targets STAGE. You can target PROD with eve start --db=PROD. STAGE and PROD both refer to remote API. To target a local running API, run eve api in one terminal to start the api (which will target STAGE db), and run eve start [AGENT_NAME] --local.