AI Integration Copilot - Production-ready AI assistant that integrates with business tools (CRM, email, calendar, team chat) to automate sales and operations workflows.

Chat Interface - Natural language interaction with AI agent

Integrations Page - Connect HubSpot, Gmail, Calendar, and more

Business professionals waste time switching between multiple tools (CRM, email, calendar, chat) to complete simple tasks. Manual data entry, context switching, and repetitive workflows reduce productivity.

BridgeAI is an intelligent assistant that:

• Unifies access to HubSpot CRM, Gmail, Google Calendar, Discord, and Google Drive
• Automates multi-step workflows through natural language
• Maintains conversation context across sessions
• Secures OAuth tokens with encryption and automatic refresh

graph TB
    subgraph "Client Layer"
        Web[Web Browser<br/>Next.js Frontend]
        Discord[Discord Client]
    end

    subgraph "API Layer"
        API[FastAPI Backend<br/>REST API + SSE]
    end

    subgraph "AI Agent Layer"
        Agent[LangGraph Agent<br/>Orchestrator]
        LLM[OpenAI GPT-4o-mini]
        Tools[Integration Tools<br/>HubSpot, Gmail, Calendar, Drive, Discord]
    end

    subgraph "Data Layer"
        DB[(PostgreSQL<br/>Users, Integrations, Conversations)]
        CheckpointDB[(PostgreSQL<br/>LangGraph Checkpoints)]
    end

    subgraph "External Services"
        HubSpot[HubSpot CRM API]
        Google[Google APIs<br/>Gmail, Calendar, Drive]
        DiscordAPI[Discord API]
    end

    Web -->|HTTP/SSE| API
    Discord -->|WebSocket| DiscordBot[Discord Bot]
    DiscordBot --> API

    API -->|JWT Auth| Agent
    API -->|CRUD| DB

    Agent -->|LLM Calls| LLM
    Agent -->|Tool Execution| Tools
    Agent -->|State Persistence| CheckpointDB

    Tools -->|OAuth API Calls| HubSpot
    Tools -->|OAuth API Calls| Google
    Tools -->|Bot API| DiscordAPI

    DB -.->|Encrypted Tokens| Tools

bridge-ai/
├── backend/              # FastAPI backend
│   ├── src/
│   │   ├── agent/       # LangGraph agent orchestration
│   │   ├── api/         # REST API routes
│   │   ├── core/        # Config, database, security
│   │   ├── integrations/# OAuth clients (HubSpot, Google, Discord)
│   │   ├── models/      # SQLAlchemy models
│   │   └── services/    # Business logic
│   └── alembic/         # Database migrations
├── frontend/            # Next.js 14 frontend
│   └── src/
│       ├── app/         # Next.js app router pages
│       ├── components/  # React components
│       ├── contexts/    # React contexts (Auth)
│       └── lib/         # Utilities & API client
└── docker-compose.yml   # Local development setup

• Docker & Docker Compose

# 1. Clone repository
git clone https://github.com/StephaneWamba/bridge-ai.git
cd bridge-ai
git checkout develop

# 2. Set up environment variables
cd backend && cp .env.example .env && cd ..
cd frontend && cp .env.example .env.local && cd ..

# 3. Start all services
docker-compose up -d

# 4. Run database migrations
docker-compose exec backend alembic upgrade head

# 5. Access services
# Frontend: http://localhost:3004
# Backend API: http://localhost:8001
# API Docs: http://localhost:8001/docs

Hot Reload: Both backend and frontend support hot reload.

• API Documentation - Complete API reference
• Architecture - System design and components
• User Guide - How to use BridgeAI
• Local Dev Setup - Detailed setup instructions
• Frontend - Frontend architecture and components

• ✅ Multi-Tool Integration: HubSpot, Gmail, Google Calendar, Discord, Google Drive
• ✅ AI-Powered Workflows: Natural language task automation
• ✅ Conversation Persistence: LangGraph checkpoints maintain state
• ✅ OAuth Security: Encrypted tokens with automatic refresh
• ✅ Real-time Streaming: SSE for live agent responses
• ✅ Discord Bot: Chat with BridgeAI via Discord
• ✅ Meeting Transcripts: Parse and summarize Google Drive transcripts

MIT License