hybrid-groups 0.0.1

A multi-user, multi-agent collaboration platform

Hybrid Groups

Hybrid Groups is a multi-user, multi-agent platform that enables teams to collaborate with proactive and reactive agents in Slack and GitHub. It adds background reasoning to Slack threads and GitHub issues to intelligently activate agents based on chat messages and context. Agents reason, act and respond specific to a user's identity, preferences and history, and can take actions on behalf of a user. In Slack, users can build custom agents with a simple agent builder. More advanced agents or agentic systems can be integrated with the Hybrid Groups Python SDK.

Quickstart

[!NOTE] The full quickstart guide is here.

1. 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 <slack | github>
   

   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.

2. Run the server:

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

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

3. 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).