Skip to content

codewithajet/whatsapp-gpt-bridge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 

Repository files navigation

πŸ’¬ WhatsApp-AI-ContextHub

MIT License API Support Platforms Download

πŸŒ€ Introduction: WhatsApp-AI-ContextHub

Welcome to WhatsApp-AI-ContextHub, the next leap in conversational AI for WhatsApp management. Our system fuses the robust communication channels of WhatsApp with a modular AI context repository. Harness the synergy of Baileys, FastMCP, and dynamic context aggregation, plus deep integrations with OpenAI and Claude APIs, to power your personal or business WhatsApp chats with intelligent, contextually aware conversations.

WhatsApp-AI-ContextHub is designed for enterprises, individuals, and AI developers who require:

  • Real-time, context-rich WhatsApp AI assistants;
  • Seamless switching between different AI engines (e.g., OpenAI GPT-4, Claude 3);
  • Shared or individual user context management with pluggable storage backends;
  • A visually responsive dashboard and console tooling.

Imagine updating your WhatsApp customer support logic on the fly, or evolving an AI-powered personal WhatsApp assistant that really remembers you.


πŸ“₯ Download & Installation

Ready to jump in?
Get started with our custom installer:

Download

Follow install instructions on the Download Page.
Compatible with major OS platforms (see below).


🌟 Features

  • Contextual Message Repository: All chats stream into a modular context store, allowing pre- and post-processing for advanced AI prompts.
  • Hybrid AI Engine Support: Effortless switching and blending between OpenAI and Claude models.
  • Responsive Web and CLI UI: Manage sessions, logs, and context from your browser or terminal.
  • Multi-Language User Experience: Out-of-the-box support for over 24 languages, detects chat input.
  • User Profile & Team Modes: Easily configure private or shared AI assistants, with access roles.
  • Pluggable Architectures: Swap in-memory, database, or distributed context backends.
  • 24/7 Customer Support Bot: Highly reliable, persistent assistant available around the clock.
  • Granular Permissions: Role-based access management for organizations.
  • Live Context Playback: Replay message flows and troubleshoot AI conversations.

πŸ“Š OS Compatibility Matrix

🌐 OS 🟒 Supported πŸ” Regularly Tested πŸ’‘ Notes
Windows 10/11 βœ… πŸš€ Installer & CLI tested
Linux (Ubuntu) βœ… πŸš€ Snap & Docker available
macOS (12+) βœ… πŸš€ M1/M2 Silicon compatible

πŸš€ Example Console Invocation

To launch WhatsApp-AI-ContextHub using CLI mode with a custom profile and context memory:

waic --profile ./profiles/team-profile.yaml \
     --context-memory redis \
     --ui web \
     --language es-MX \
     --openai-api-key sk-xxxxxxx \
     --claude-api-key claude-xxxx

Monitor the console for live session info, incoming message contexts, and access the web UI at localhost:8080.


πŸ“ Example Profile Configuration

YAML example profile for a support team:

profile_name: "SupportTeam"
ai_engine: "openai"
languages:
  - en-US
  - es-MX
context_backend: "redis"
context_retention_days: 14
roles:
  admin: ["+12345678912"]
  support: ["+19876543210", "+11234567890"]
response_style: "concise"
fallback_engine: "claude"
allowed_hours: "08:00-22:00"
enable_customer_support_bot: true

🌐 API Integrations

Out-of-the-box support for:

  • OpenAI API (ChatGPT series, GPT-4, and Whisper models)
  • Claude API (Anthropic Claude, Claude 3, Claude Instant)

Switch models easily for best pricing/performance.
Configure API keys via environment variables or securely in the web dashboard.


πŸ“ˆ SEO-Driven Use Cases

  • Intelligent WhatsApp Automation
  • AI-Driven Customer Service on WhatsApp
  • WhatsApp AI Chatbot with Customizable Context Memory
  • Enterprise WhatsApp Team AI
  • Multilingual WhatsApp Virtual Assistant
  • WhatsApp AI Integration with OpenAI and Claude
  • Adaptive AI-powered Customer Engagement

πŸ—ΊοΈ System Architecture

Here’s how WhatsApp-AI-ContextHub orchestrates conversations:

flowchart LR
    U[User on WhatsApp] -- Message --> B[Baileys Listener]
    B -- Enrich Context --> C[Context Repository]
    C -- Build Prompt --> E[AI Engine: OpenAI / Claude]
    E -- AI Response --> B
    B -- Send Message --> U
    C -- Log & Replay --> D[Admin Dashboard]
    D -- Manage Users --> C
    D -- Configure API Keys --> E
Loading

πŸ’‘ Why WhatsApp-AI-ContextHub?

We believe AI-chat interactions are not just about replyingβ€”they’re about remembering, evolving, and understanding. This project is a bridge:
πŸ”— Between WhatsApp’s ecosystem and the cloud of intelligence
πŸ”— Between your needs and flexible, robust automation
πŸ”— Between different AI backends (OpenAI, Claude) and a consistent user experience


πŸ™Œ 24/7 Customer Support

Never feel alone at 2am!
Our AI-powered customer support module ensures your WhatsApp assistant is always ready. Configurable escalation and self-learning FAQ included.


🌍 Multilingual UI and Language Detection

Chat in your preferred languageβ€”our assistant auto-detects input, responds, and translates accordingly. Fully localizable web dashboard lets you configure new languages in a breeze.


πŸ›‘οΈ Disclaimer

WhatsApp-AI-ContextHub is an independent creative project.
We respect the terms of service of any third-party APIs, and encourage users to follow legal and ethical practices in all integrations. This solution is not a product of WhatsApp LLC or affiliated with OpenAI or Anthropic.


©️ License

MIT License β€” 2026
Read Full License


πŸ“₯ Download Hub

Download
Follow setup instructions after download.


Empower your WhatsApp with the adaptive intelligence it deserves β€” with WhatsApp-AI-ContextHub! πŸš€

Releases

No releases published

Packages

 
 
 

Contributors