Skip to content

Application server

Slack

To serve the Slack app with the provided example agents and group reasoner, run:

python -m hygroup.scripts.server \
  --gateway slack \
  --factory-module hygroup.factory.example

Channel-specific agents

Channel-specifc agents and group reasoners can be configured with the --channel-factory-module option. For example, to use specialized agents and group reasoner in a customer-support channel while using the default configuration elsewhere:

uv run python -m hygroup.scripts.server \
  --gateway slack \
  --factory-module hygroup.factory.example \
  --channel-factory-module customer-support:myproject.factory.support

The --channel-factory-module option accepts the format channel_name:module.path and can be specified multiple times for different channels. Channels without specific configuration will use the agents and group reasoner from the default --factory-module.

Manual action approval

To enable manual approval of agent actions via ephemeral messages, use the --user-channel slack option:

python -m hygroup.scripts.server \
  --gateway slack \
  --factory-module hygroup.factory.example \
  --user-channel slack

GitHub

To serve the GitHub app with the provided example agents and group reasoner, run:

python -m hygroup.scripts.server \
  --gateway github \
  --factory-module hygroup.factory.example

Channel-specific configuration not available

The --channel-factory-module option is only available for Slack integrations, not for GitHub.

The GitHub app server additionally requires a smee.io channel for webhook payload delivery to the local server. A channel is generated during the GitHub app setup and stored in the .env file as GITHUB_APP_WEBHOOK_URL. To connect to the channel, install the smee client and run:

source .env \
&& smee -u $GITHUB_APP_WEBHOOK_URL -t http://127.0.0.1:8000/api/v1/github-webhook