Local Setup Guide
This is a condensed version of our Local Installation Guide
Step 1. Download the Installation Files
Manual Download
-
Go to the Install Option for your Architecture
- Project Install Page for x86: Visit docker-x86 .
- Project Install Page for ARM64: Visit docker-arm .
- Project Install Page for Windows: Visit docker-windows .
-
Download the ZIP File: Click the green “Code” button, then click “Download ZIP.”
-
Extract the ZIP File: Find the downloaded ZIP file, right-click, and select “Extract All…”.
Using Git
Run the following git command in your terminal, from the desired parent directory:
git clone https://github.com/ecogenetic/ecosystem.gitTo update to the latest install options and files:
git pullStep 2. Install Docker
- Download: Go to Docker Desktop Download Page and download Docker Desktop.
- Install: Open the installer and follow the instructions.
- Run: Open Docker Desktop to ensure it is running.
Notes:
- Docker Desktop is recommended for most users.
- You may need to restart your computer after installation.
Step 3. Run the App
-
Navigate to the Project Directory
-
Create and Configure .env File:
- Copy the contents of
ecosystem_env.txtto a new file named.env. - Fill in any necessary values.
Add your keys.
ECOSYSTEM_API_KEYis the license.OPENAI_API_KEYis only needed for generative paths.DATA_PATH=./data OPENAI_API_KEY= ECOSYSTEM_API_KEY= - Copy the contents of
-
Start the Application: Find your correct install folder. Run the following command from within the install directory:
- ARM64
cd ecosystem/docker-arm ./start.sh- x86
cd ecosystem/docker-x86 ./start_x86.sh- Windows
cd ecosystem\docker-windows start.bat -
Run the App:
Now that your files are configured and the app started, you can access the app:
http://127.0.0.1OR
http://localhost
Post-Install
Log in and wire Grafana using the Post Install Setup Guide.
Then score something:
- Open the Runtime Dashboard against port 8091 (or 8099 if that is how you launched Runtime).
- Invoke a campaign, then Accept an offer (
POST /response). - Optional: campaign BDD tests and ontology for agents.
Hosted demo if you are not running locally: https://medemo.ecosystem.ai .
Conclusion
That’s it! You should now have ecosystem.Ai running locally on your machine. Enjoy!
Additional Links
Explore more about ecosystem.Ai and how to configure it to your needs.
- Updating ecosystem.Ai
- Instructions on how to update this setup with the latest changes to ecosystem.Ai.
- Configuration
- How to use ecosystem.Ai product.