Launch an agent#

The agent is core component in the InteractEM system for running operator containers, and coordinating their lifecycle and via NATS messaging.

Prerequisites#

Some python environment manager (e.g., poetry or uv).

Set up Environment Variables

You should have already run make setup in the root directory. Then go to agent directory:

cd backend/agent

Update the .env file for the agent. You can for example set the agent’s name by changing AGENT_NAME:

AGENT_NAME=SecretAgentMan # change to how you want it to display in the frontend

If you have specific tags to match an operator on, run the following:

AGENT_TAGS='["ncem-4dcamera","gpu"]'

poetry install

uv sync

Activate your virtual environment, then the following inside the directory where the .env is:

cd backend/agent
interactem-agent

or with uv:

cd backend/agent
uv run interactem-agent