hybrid-groups 0.0.5

A multi-user, multi-agent collaboration platform

Hybrid Groups

Overview

Hybrid Groups is a multi-user, multi-agent collaboration platform that enables users to interact with both agents and other users in group chats on Slack and GitHub. Agents act and respond according to each user's identity, preferences and privileges, enabling secure access to a user's private resources while collaborating in a team.

Quickstart

[!NOTE] The full quickstart guide is here.

1. Configure the app type to install and run, slack or github:

   export APP_TYPE=slack # or "github"
   

2. Setup the app (prints the setup URL to follow in the output) - only required once per app:

   docker run --rm -it \
       -v "$(pwd)/.data-docker":/app/.data \
       -p 8801:8801 \
       ghcr.io/gradion-ai/hybrid-groups:latest \
       setup $APP_TYPE
   

   Important: when running the container on a remote host, supply the hostname or IP address via the --host parameter. After setting up the Slack app, add it to any Slack channels you want it to be active in. You can do this from the channel's menu under Open channel details -> Integrations -> Add apps.

3. Run the server:

   docker run --rm -it \
       -v "$(pwd)/.data-docker":/app/.data \
       ghcr.io/gradion-ai/hybrid-groups:latest \
       server $APP_TYPE
   

   To enable user channels in Slack, append the --user-channel slack option.

4. Verify that your installation works. For example, activate the weather agent via background reasoning by entering

   how's the weather in vienna?
   

   in the channel where the Slack app was added

   

   or in the description of a new GitHub issue:

   

   For directly mentioning the weather agent in Slack, use @weather at the beginning of a message, in GitHub use @hybrid-groups/weather (and replace hybrid-groups with the GitHub app name you've chosen).