Quickstart

Ensure you have Node.js and Helm installed. Then run the following commands to install Ark:

# Install the 'ark' CLI:
npm install -g @agents-at-scale/ark

# Install Ark:
ark install

# Optionally configure a 'default' model to use for agents:
ark models create default

# Run the dashboard:
ark dashboard

In most cases the default installation options will be sufficient. This will install the Ark dependencies, the controller, the APIs and the dashboard. You can optionally setup a default model that will be the default used by agents. You will need a Kubernetes cluster to install Ark into, you can use Minikube, Kind, Docker Desktop or similar to run a local cluster. The install command will warn if any required dependencies are missing.

User guides, developer guides, operations guides and API reference documentation is all available at:

https://mckinsey.github.io/agents-at-scale-ark/

The Quickstart guide will walk you through the process of configuring a model, creating an agent and running basic queries.

To troubleshoot an installation, run ark status.

Configuration

You can customize Ark service installations using a .arkrc.yaml file in your home directory (~/.arkrc.yaml) or project directory. This allows you to override service properties like enabled status, namespace, or chart location.

Example .arkrc.yaml:

services:
  localhost-gateway:
    enabled: true
  ark-controller:
    namespace: custom-namespace

This example enables the localhost-gateway service (disabled by default) and changes the namespace for ark-controller.

Installing Agents @ Scale

To install the Agents @ Scale platform with JFrog container registry credentials:

services:
  agents-at-scale:
    enabled: true
    installArgs:
      - --set
      - containerRegistry.enabled=true
      - --set
      - containerRegistry.username=YOUR_USERNAME
      - --set
      - containerRegistry.password=YOUR_PASSWORD

Replace YOUR_USERNAME and YOUR_PASSWORD with your JFrog credentials.