BindAI Connections

bindai-connections provides integrations between BindAI applications and external services.

The package defines a common connection abstraction, connection management and registry components, together with built-in integrations for commonly used services.

Features

• Connection abstraction
• Connection manager
• Connection registry
• Webhook integration
• Slack integration
• Notion integration
• Jira integration
• Discord integration
• Resend integration
• Vercel integration
• Netlify integration
• GitHub connection support
• Centralized connection registration

Public API

The package exposes:

from bindai_connections import (
    Connection,
    ConnectionManager,
    ConnectionRegistry,
)

Built-in integrations include:

from bindai_connections import (
    WebhookConnection,
    SlackConnection,
    NotionConnection,
    JiraConnection,
    DiscordConnection,
    ResendConnection,
    VercelConnection,
    NetlifyConnection,
    GitHubConnection,
)

Connection Abstraction

Connection provides the common abstraction for external service integrations.

from bindai_connections import Connection

This allows higher-level BindAI components to work with integrations through a consistent connection layer.

Connection Manager

ConnectionManager provides the management layer for connections.

from bindai_connections import ConnectionManager

manager = ConnectionManager()

The manager can be used by applications that need to organize and work with multiple external integrations.

Connection Registry

ConnectionRegistry provides centralized connection registration and lookup.

from bindai_connections import ConnectionRegistry

The package registers its built-in connection types under provider keys during initialization.

Current registered connection keys include:

webhook
slack
notion
jira
discord
resend
vercel
netlify

This allows integrations to be resolved through the registry instead of requiring consumers to hard-code a particular connection implementation.

Supported Integrations

Webhooks

WebhookConnection provides the connection abstraction for webhook-based integrations.

from bindai_connections import WebhookConnection

Slack

SlackConnection provides the BindAI connection for Slack.

from bindai_connections import SlackConnection

Notion

NotionConnection provides the BindAI connection for Notion.

from bindai_connections import NotionConnection

Jira

JiraConnection provides the BindAI connection for Jira.

from bindai_connections import JiraConnection

Discord

DiscordConnection provides the BindAI connection for Discord.

from bindai_connections import DiscordConnection

Resend

ResendConnection provides the BindAI connection for Resend.

from bindai_connections import ResendConnection

Vercel

VercelConnection provides the BindAI connection for Vercel.

from bindai_connections import VercelConnection

Netlify

NetlifyConnection provides the BindAI connection for Netlify.

from bindai_connections import NetlifyConnection

GitHub

GitHubConnection is also exposed as part of the public API.

from bindai_connections import GitHubConnection

Architecture

The connections package separates external integrations from the rest of the BindAI application architecture:

BindAI Application / Agent
          │
          ▼
 ConnectionManager
          │
          ▼
 ConnectionRegistry
          │
    ┌─────┼────────────────────────┐
    │     │                        │
    ▼     ▼                        ▼
 Webhook Slack ...             GitHub
 Connection Connection          Connection

This keeps integration concerns isolated from application and agent execution logic.

BindAI Integration

bindai-connections is intended for applications that need to communicate with external services.

Connections can be used as reusable integration components alongside BindAI applications, agents, workflows, and automation.

The package focuses on connection abstractions and integrations rather than implementing the core agent or workflow execution system.

Version

The current package version exposed by the package is:

from bindai_connections import __version__

print(__version__)

Current version: 0.1.0.

Development

This package is part of the BindAI workspace.

From the repository root:

uv sync

Run the complete test suite:

uv run pytest

Run static type checking for this package:

uv run mypy packages/bindai-connections

Build the package:

uv build --package bindai-connections

Documentation

For complete BindAI framework documentation:

https://docs.bindai.dev

License

BindAI is released under the MIT License.