npm package: @poolzin/pool-bot
Description: 🎱 Pool Bot - AI assistant with PLCODE integrations
Latest version: 2026.4.55

# 🎱 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.

[![npm version](https://img.shields.io/npm/v/@poolzin/pool-bot)](https://www.npmjs.com/package/@poolzin/pool-bot)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Documentation](https://img.shields.io/badge/docs-docs.poolbot.dev-green)](https://docs.poolbot.dev)

![Pool Bot](README-header.png)

---

## ✨ 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

```bash
# 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:

```yaml
# 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](https://docs.poolbot.dev/skills/creating)

---

## 🏗️ 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](https://github.com/plcunha/pool-apps) |
| **Android** | Native messaging, notifications, device automation | [pool-apps](https://github.com/plcunha/pool-apps) |
| **iOS/macOS** | Apple ecosystem integration, Shortcuts support | [pool-apps](https://github.com/plcunha/pool-apps) |

---

## 💻 Development

```bash
# 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](https://docs.poolbot.dev/getting-started)** - Installation and first steps
- **[Configuration](https://docs.poolbot.dev/configuration)** - Profiles, channels, and providers
- **[Skills](https://docs.poolbot.dev/skills)** - Built-in and custom skills
- **[Architecture](https://docs.poolbot.dev/architecture)** - Mesh networking, memory, security
- **[API Reference](https://docs.poolbot.dev/api)** - REST API and webhooks
- **[Deployment](https://docs.poolbot.dev/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](https://docs.poolbot.dev/security)

---

## 🤝 Community

- **Discord:** [discord.gg/poolbot](https://discord.gg/poolbot)
- **GitHub Issues:** [Report bugs, request features](https://github.com/plcunha/pool-bot/issues)
- **Discussions:** [Q&A, show and tell](https://github.com/plcunha/pool-bot/discussions)

---

## 📄 License

MIT License - see [LICENSE](LICENSE) file for details.

---

**Made with 🎱 by [João Vitor Cunha](https://github.com/plcunha)**