Mac

Install Brew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Install Python3 and libgit2 using brew

brew install [email protected] libgit2

Windows

Install Chocolatey

Make sure Python user Scripts folder is in PATH (python -m site --user-base)

Install Python3 using choco

choco install python3

Scripts

There are two methods to setup your local development

1. Global Python environment
2. Using a virtual environment (recommended)

Clone

Method 1: Global Python environment

This will clone a bot into a subdirectory relative to your current path using global Python interpreter.

MEYA_AUTH_TOKEN=xxx
GRID_URL=https://grid.meya.ai
APP_ID=app-xxx

pip3 install --upgrade \
    --extra-index-url https://meya:[email protected]/registry/pypi \
    "pygit2>=1.2.1" \
    "meya-sdk>=2.0.0" \
    "meya-cli>=2.0.0"
# [optional] auth only required once per system
meya auth add \
  --grid-url $GRID_URL \
  --auth-token $MEYA_AUTH_TOKEN
meya clone \
  --grid-url $GRID_URL \
  --app-id $APP_ID

Method 2: venv

This will clone a bot into your existing directory using venv.

MEYA_AUTH_TOKEN=xxx
GRID_URL=https://grid.meya.ai
APP_ID=app-xxx
DIR_NAME=app-name

mkdir $DIR_NAME && cd $DIR_NAME || exit
python3 -m venv venv
. venv/bin/activate
pip3 install --upgrade \
    --extra-index-url https://meya:[email protected]/registry/pypi \
    "pygit2>=1.2.1" \
    "meya-sdk>=2.0.0" \
    "meya-cli>=2.0.0"
# [optional] auth only required once per system
meya auth add \
  --grid-url $GRID_URL \
  --auth-token $MEYA_AUTH_TOKEN
meya clone \
  --grid-url $GRID_URL \
  --app-id $APP_ID \
  --directory temp \
  && cp -a temp/. . && rm -rf temp

Copy secrets and push

ACCOUNT_ID=acct-xxx
APP_NAME="app-name [username]"

meya vault download --file vault.secret.yaml
meya connect new \
  --app-name=$APP_NAME \
  --account-id=$ACCOUNT_ID \
  --grid-url $GRID_URL
meya vault upload --file vault.secret.yaml
meya push --force --build-image

Walk-through videos

Global installation
Virtual environment installation