hybrid-groups


Namehybrid-groups JSON
Version 0.0.3 PyPI version JSON
download
home_pageNone
SummaryA multi-user, multi-agent collaboration platform
upload_time2025-07-16 12:42:44
maintainerNone
docs_urlNone
authorMartin Krasser
requires_python<3.14,>=3.11
licenseApache-2.0
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Hybrid Groups

<p align="left">
    <a href="https://gradion-ai.github.io/hybrid-groups/"><img alt="Website" src="https://img.shields.io/website?url=https%3A%2F%2Fgradion-ai.github.io%2Fhybrid-groups%2F&up_message=online&down_message=offline&label=docs"></a>
    <a href="https://pypi.org/project/hybrid-groups/"><img alt="PyPI - Version" src="https://img.shields.io/pypi/v/hybrid-groups?color=blue"></a>
    <a href="https://github.com/gradion-ai/hybrid-groups/releases"><img alt="GitHub Release" src="https://img.shields.io/github/v/release/gradion-ai/hybrid-groups"></a>
    <a href="https://github.com/gradion-ai/hybrid-groups/actions"><img alt="GitHub Actions Workflow Status" src="https://img.shields.io/github/actions/workflow/status/gradion-ai/hybrid-groups/test.yml"></a>
    <a href="https://github.com/gradion-ai/hybrid-groups/blob/main/LICENSE"><img alt="GitHub License" src="https://img.shields.io/github/license/gradion-ai/hybrid-groups?color=blueviolet"></a>
</p>

[*Hybrid Groups*](https://gradion-ai.github.io/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.

<table>
<tr>
<td><a href="https://gradion-ai.github.io/hybrid-groups/images/overview/overview-1.png" target="_blank"><img src="https://gradion-ai.github.io/hybrid-groups/images/overview/overview-1.png" alt="Hybrid Groups" /></a></td>
<td><a href="https://gradion-ai.github.io/hybrid-groups/images/overview/overview-2.png" target="_blank"><img src="https://gradion-ai.github.io/hybrid-groups/images/overview/overview-2.png" alt="Hybrid Groups" /></a></td>
<td><a href="https://gradion-ai.github.io/hybrid-groups/images/overview/overview-3.png" target="_blank"><img src="https://gradion-ai.github.io/hybrid-groups/images/overview/overview-3-crop.png" alt="Hybrid Groups" /></a></td>
</tr>
</table>

## Quickstart

> [!NOTE]
> The full quickstart guide is [here](https://gradion-ai.github.io/hybrid-groups/quickstart).

1. Setup the app (prints the setup URL to follow in the output) - **only required once per app**:
    ```bash
    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:
    ```bash
    docker run --rm -it \
        -v "$(pwd)/.data-docker":/app/.data \
        ghcr.io/gradion-ai/hybrid-groups:latest \
        server <slack | github>
    ```
    To enable [user channels](https://gradion-ai.github.io/hybrid-groups/app-server/#slack) 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

    ```markdown
    how's the weather in vienna?
    ```

    in the channel where the Slack app was added

    <a href="https://gradion-ai.github.io/hybrid-groups/images/quickstart/quickstart-1.png" target="_blank"><img src="https://gradion-ai.github.io/hybrid-groups/images/quickstart/quickstart-1.png" class="thumbnail"></a>

    or in the description of a new GitHub issue:

    <a href="https://gradion-ai.github.io/hybrid-groups/images/quickstart/quickstart-2.png" target="_blank"><img src="https://gradion-ai.github.io/hybrid-groups/images/quickstart/quickstart-2.png" class="thumbnail"></a>

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


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "hybrid-groups",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<3.14,>=3.11",
    "maintainer_email": null,
    "keywords": null,
    "author": "Martin Krasser",
    "author_email": "martin@gradion.ai",
    "download_url": "https://files.pythonhosted.org/packages/0b/c8/478bd6dad85c065e710efe7de397e20ff3ec8e9a2149f5c1a41324ffc405/hybrid_groups-0.0.3.tar.gz",
    "platform": null,
    "description": "# Hybrid Groups\n\n<p align=\"left\">\n    <a href=\"https://gradion-ai.github.io/hybrid-groups/\"><img alt=\"Website\" src=\"https://img.shields.io/website?url=https%3A%2F%2Fgradion-ai.github.io%2Fhybrid-groups%2F&up_message=online&down_message=offline&label=docs\"></a>\n    <a href=\"https://pypi.org/project/hybrid-groups/\"><img alt=\"PyPI - Version\" src=\"https://img.shields.io/pypi/v/hybrid-groups?color=blue\"></a>\n    <a href=\"https://github.com/gradion-ai/hybrid-groups/releases\"><img alt=\"GitHub Release\" src=\"https://img.shields.io/github/v/release/gradion-ai/hybrid-groups\"></a>\n    <a href=\"https://github.com/gradion-ai/hybrid-groups/actions\"><img alt=\"GitHub Actions Workflow Status\" src=\"https://img.shields.io/github/actions/workflow/status/gradion-ai/hybrid-groups/test.yml\"></a>\n    <a href=\"https://github.com/gradion-ai/hybrid-groups/blob/main/LICENSE\"><img alt=\"GitHub License\" src=\"https://img.shields.io/github/license/gradion-ai/hybrid-groups?color=blueviolet\"></a>\n</p>\n\n[*Hybrid Groups*](https://gradion-ai.github.io/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.\n\n<table>\n<tr>\n<td><a href=\"https://gradion-ai.github.io/hybrid-groups/images/overview/overview-1.png\" target=\"_blank\"><img src=\"https://gradion-ai.github.io/hybrid-groups/images/overview/overview-1.png\" alt=\"Hybrid Groups\" /></a></td>\n<td><a href=\"https://gradion-ai.github.io/hybrid-groups/images/overview/overview-2.png\" target=\"_blank\"><img src=\"https://gradion-ai.github.io/hybrid-groups/images/overview/overview-2.png\" alt=\"Hybrid Groups\" /></a></td>\n<td><a href=\"https://gradion-ai.github.io/hybrid-groups/images/overview/overview-3.png\" target=\"_blank\"><img src=\"https://gradion-ai.github.io/hybrid-groups/images/overview/overview-3-crop.png\" alt=\"Hybrid Groups\" /></a></td>\n</tr>\n</table>\n\n## Quickstart\n\n> [!NOTE]\n> The full quickstart guide is [here](https://gradion-ai.github.io/hybrid-groups/quickstart).\n\n1. Setup the app (prints the setup URL to follow in the output) - **only required once per app**:\n    ```bash\n    docker run --rm -it \\\n        -v \"$(pwd)/.data-docker\":/app/.data \\\n        -p 8801:8801 \\\n        ghcr.io/gradion-ai/hybrid-groups:latest \\\n        setup <slack | github>\n    ```\n    **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`.\n\n2. Run the server:\n    ```bash\n    docker run --rm -it \\\n        -v \"$(pwd)/.data-docker\":/app/.data \\\n        ghcr.io/gradion-ai/hybrid-groups:latest \\\n        server <slack | github>\n    ```\n    To enable [user channels](https://gradion-ai.github.io/hybrid-groups/app-server/#slack) in Slack, append the `--user-channel slack` option.\n\n3. Verify that your installation works. For example, activate the `weather` agent via background reasoning by entering\n\n    ```markdown\n    how's the weather in vienna?\n    ```\n\n    in the channel where the Slack app was added\n\n    <a href=\"https://gradion-ai.github.io/hybrid-groups/images/quickstart/quickstart-1.png\" target=\"_blank\"><img src=\"https://gradion-ai.github.io/hybrid-groups/images/quickstart/quickstart-1.png\" class=\"thumbnail\"></a>\n\n    or in the description of a new GitHub issue:\n\n    <a href=\"https://gradion-ai.github.io/hybrid-groups/images/quickstart/quickstart-2.png\" target=\"_blank\"><img src=\"https://gradion-ai.github.io/hybrid-groups/images/quickstart/quickstart-2.png\" class=\"thumbnail\"></a>\n\n    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).\n\n",
    "bugtrack_url": null,
    "license": "Apache-2.0",
    "summary": "A multi-user, multi-agent collaboration platform",
    "version": "0.0.3",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "559d8d6c7ed7ca31e0847276dd5cf47da3ea09ed3ac1dd1a1f614775b541cb85",
                "md5": "c320b335ae6235f408f21a1242bbefcc",
                "sha256": "79147bf71c86780ce69898576b79cffc0f468821ba60f84617920743812375f6"
            },
            "downloads": -1,
            "filename": "hybrid_groups-0.0.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "c320b335ae6235f408f21a1242bbefcc",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.14,>=3.11",
            "size": 4698747,
            "upload_time": "2025-07-16T12:42:42",
            "upload_time_iso_8601": "2025-07-16T12:42:42.657303Z",
            "url": "https://files.pythonhosted.org/packages/55/9d/8d6c7ed7ca31e0847276dd5cf47da3ea09ed3ac1dd1a1f614775b541cb85/hybrid_groups-0.0.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "0bc8478bd6dad85c065e710efe7de397e20ff3ec8e9a2149f5c1a41324ffc405",
                "md5": "c2047741892fd08bcd6d9cdb225c5fd3",
                "sha256": "c91b071d009a866c3170a228f5cea6bee9188f37778530f0a049eff598cf7a43"
            },
            "downloads": -1,
            "filename": "hybrid_groups-0.0.3.tar.gz",
            "has_sig": false,
            "md5_digest": "c2047741892fd08bcd6d9cdb225c5fd3",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.14,>=3.11",
            "size": 4667746,
            "upload_time": "2025-07-16T12:42:44",
            "upload_time_iso_8601": "2025-07-16T12:42:44.597344Z",
            "url": "https://files.pythonhosted.org/packages/0b/c8/478bd6dad85c065e710efe7de397e20ff3ec8e9a2149f5c1a41324ffc405/hybrid_groups-0.0.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-16 12:42:44",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "hybrid-groups"
}
        
Elapsed time: 0.45723s