Getting Started#

Running locally#

Prerequisites#

  • Docker Desktop and Podman Desktop (recommended for easiest setup)

  • NATS Tools: Command-line utilities for interacting with NATS

Configuration#

  1. Create a .env and setup environment variables

    Create a .env

    cd interactEM
    cp .env.example .env
    

    Add Github and personal token information in .env file. You will need to get this from your github account.

    GITHUB_USERNAME=your_github_username
    GITHUB_TOKEN=your_personal_token
    
  2. Generate NATS Authentication Files
    Generate auth.conf for the NATS cluster and various .creds and .nk files for NATS authentication.

    cd conf/nats-conf
    ./generate-auth-jwt.sh
    

Building Docker Images and starting services#

  1. Build the Required Images

    docker/bake.sh
    
  2. Bring up Services

    docker compose up --force-recreate --remove-orphans --build -d
    
  3. Login

    Go to http://localhost:5173/ in your browser, and you should see a login page. The credentials for the local version are in ./.env.example.

    FIRST_SUPERUSER_USERNAME=admin@example.com
    FIRST_SUPERUSER_PASSWORD=changethis
    

Now you should have the full stack running in docker. Go to launch agent.