🎱 Pool Bot

The AI Gateway for Teams That Need More Than Chatbots

Pool Bot transforms your messaging apps into a powerful AI command center. Connect Claude, GPT, Gemini, and local models to WhatsApp, Telegram, Discord, Slack, Signal, and 15+ other channels—then extend with custom skills for your specific workflows.

✨ What Makes Pool Bot Different

| Feature | What It Means For You | |---------|----------------------| | 🧩 Modular Skills System | Add capabilities via YAML-based skills—no coding required for most extensions | | 🌐 Universal Gateway | One AI backend, unlimited channels. Add new messaging platforms without reconfiguration | | 🧠 Advanced Memory | MMR reranking, temporal decay, hybrid search—conversations that actually remember context | | ⚡ Provider Infrastructure | Multi-key pools, intelligent rate limiting, automatic failover across 10+ LLM providers | | 🔒 Security-First | Command approval workflows, audit logging, PII detection, configurable guardrails | | 📱 Device Control | Pair iOS/Android devices for remote automation, screenshots, and notifications |

🚀 Quick Start

# Install globally
npm install -g @poolzin/pool-bot

# Start the gateway
poolbot gateway start

# Connect your first channel
poolbot channels login whatsapp

# Check everything is running
poolbot status

That's it. Your AI assistant is now available on WhatsApp. Add more channels anytime.

📡 Supported Channels

Messaging Platforms: WhatsApp • Telegram • Discord • Slack • Signal • iMessage • Facebook Messenger • Instagram • LINE • Matrix • Mattermost • Zalo • Microsoft Teams

Voice & Web: Web Interface • WebRTC • Voice Calls

Custom: Webhooks • API • Custom integrations via skills

🤖 Supported AI Providers

| Provider | Models | Features | |----------|--------|----------| | Anthropic | Claude 3.5/3 Opus/Sonnet/Haiku | Full tool use, vision, extended thinking | | OpenAI | GPT-4o, GPT-4, GPT-3.5 | Function calling, vision, DALL-E | | Google | Gemini 1.5 Pro/Flash | Multimodal, 1M+ context window | | Groq | Llama 3, Mixtral | Ultra-fast inference | | Ollama | Local models | Privacy-first, offline capable | | Together | 50+ open models | Mixtral, Llama, Qwen, and more | | OpenRouter | 100+ models | Unified API for multiple providers | | Mistral | Mistral Large/Medium/Small | European AI, GDPR compliant | | Cohere | Command R/R+ | Enterprise-focused | | AI21 | Jamba/Jurassic | Long context specialist |

🛠️ Skills System

Pool Bot's unique skill system lets you add capabilities without touching core code:

# Example: Weather Skill (skills/weather/SKILL.md)
---
name: weather
description: Get weather forecasts
tools:
  - name: get_weather
    description: Get current weather for a location
    parameters:
      location: string
      units: enum[celsius, fahrenheit]
---

Built-in Skills:

• 🎮 WebGPU Three.js - 3D development and visualization
• 🔍 GitHub - Issues, PRs, CI/CD management
• 🌦️ Weather - Current conditions and forecasts
• 📝 Notion - Database and page management
• 🐦 X/Twitter - Social media automation
• 📧 Gmail - Email management
• 📅 Calendar - Schedule management
• 🔐 1Password - Secure credential access
• 🎨 Canvas - Visual browser automation
• 🖼️ Image Generation - DALL-E, Stable Diffusion integration

Create your own: See Creating Skills

🏗️ Architecture Highlights

Provider Infrastructure

• Multi-key pools - Rotate across multiple API keys for higher rate limits
• Intelligent routing - Route by model capability, cost, or latency
• Automatic failover - Seamless fallback when providers degrade
• Usage tracking - Per-key, per-model cost analytics

Memory System

• Semantic search - Find relevant context across conversation history
• MMR reranking - Diverse, non-redundant context retrieval
• Temporal decay - Recent conversations weighted higher
• Hybrid search - Combine vector similarity with keyword matching

📱 Companion Apps

Extend Pool Bot to your devices:

| Platform | Features | Repository | |----------|----------|------------| | Windows | Local LLM, STT/TTS, automation, system control | pool-apps | | Android | Native messaging, notifications, device automation | pool-apps | | iOS/macOS | Apple ecosystem integration, Shortcuts support | pool-apps |

💻 Development

# Clone and setup
git clone https://github.com/plcunha/pool-bot.git
cd pool-bot
pnpm install

# Development mode
pnpm dev

# Build
pnpm build

# Run tests
pnpm test

# Lint and format
pnpm lint
pnpm format

📚 Documentation

• Getting Started - Installation and first steps
• Configuration - Profiles, channels, and providers
• Skills - Built-in and custom skills
• Architecture - Mesh networking, memory, security
• API Reference - REST API and webhooks
• Deployment - Docker, cloud, and self-hosting

🔐 Security

• Command Approval - Require human approval for destructive operations
• Audit Logging - Complete trace of all AI actions
• PII Detection - Automatic redaction of sensitive data
• Sandboxed Execution - Isolated environment for untrusted skills
• End-to-End Encryption - For supported channels

See Security Documentation

🤝 Community

• Discord: discord.gg/poolbot
• GitHub Issues: Report bugs, request features
• Discussions: Q&A, show and tell

📄 License

MIT License - see LICENSE file for details.

Made with 🎱 by João Vitor Cunha