Buidl

AI-powered dev bot that executes commands and builds things via Slack

🚀 Get Started 📦 Download v1.1.0 ⚡ WebSocket Setup

✨ Key Features

🚀

WebSocket Support

Real-time bidirectional communication with 75-90% faster response times (50-200ms vs 500-2000ms HTTP).

Setup WebSocket →
🧠

AI-Powered Responses

Uses OpenRouter (Claude 3.5 Sonnet) for intelligent, context-aware conversations with your development team.

Configure AI →
🔍

Vector Embeddings

Searches conversation history using semantic similarity for relevant context and intelligent responses.

Learn More →
🔐

Privacy-First

Configurable privacy levels with local embedding options for maximum data protection and compliance.

Privacy Guide →
⚡

High Performance

LSH indexing for sub-linear search performance and efficient message processing at scale.

Performance →
🔧

Easy Deployment

No public webhook URLs needed with Socket Mode - simplified networking and enhanced security.

Deploy →

🚀 Quick Start

macOS (Pre-built Binary)

# Download and install
curl -L https://github.com/twilson63/buidl/releases/latest/download/buidl-v1.1.0-macos-arm64.tar.gz -o buidl.tar.gz
tar -xzf buidl.tar.gz
cd macos-arm64
./install.sh

# Configure
buidl-config

# Start bot
buidl

Any Platform (Source)

# Download source
curl -L https://github.com/twilson63/buidl/releases/latest/download/buidl-v1.1.0-source.tar.gz -o buidl-source.tar.gz
tar -xzf buidl-source.tar.gz
cd source

# Build (requires Hype framework)
./build.sh

# Configure and run
./buidl-config
./buidl-socket
💡 Pro Tip: Use WebSocket Socket Mode for the best performance! It's 75-90% faster than HTTP Events API.

📊 Performance Comparison

| Feature | HTTP Events API | Socket Mode | Improvement | |---------|----------------|-------------|-------------| | **Latency** | 500-2000ms | 50-200ms | **75-90% faster** | | **Connection** | Stateless HTTP | Persistent WebSocket | **Real-time** | | **Deployment** | Complex (webhooks) | Simple (outbound only) | **Simplified** | | **Security** | Public endpoints | Outbound connections | **Enhanced** | | **Development** | ngrok required | Local testing friendly | **Easier** |

🏗️ Architecture Overview

┌─────────────────┐    WebSocket    ┌──────────────────┐
│   Slack API     │◄─── Secure ────►│  Buidl Bot       │
│  Socket Mode    │     Connection  │  (Local/Private) │
└─────────────────┘                 └──────────────────┘
                                            │
                                            ▼
                                    ┌──────────────────┐
                                    │  Vector Database │
                                    │  AI Processing   │
                                    │  Local Storage   │
                                    └──────────────────┘

Components

  • Slack Integration - WebSocket Socket Mode or HTTP Events API
  • Vector Database - Semantic search with privacy-conscious embeddings
  • AI Processing - Context-aware response generation
  • OpenRouter - Claude 3.5 Sonnet integration for intelligent responses

📖 Documentation

📚

Getting Started

Complete installation guide with step-by-step instructions for all platforms.

Start Here →
⚡

WebSocket Setup

Enable Socket Mode for real-time performance and simplified deployment.

Setup Guide →
⚙️

Configuration

Complete reference for all configuration options and environment variables.

Configure →
🔌

API Reference

Detailed API documentation with examples for extending and integrating.

API Docs →

🌟 Community & Support

Ready to supercharge your Slack workspace with AI? Get started now →