Skip to content

Repository files navigation

πŸ“ Boosters - A rooster agent for Slack ✨

Boosters is a Slack AI assistant built on Cloudflare Workers. It uses function-calling tools to fetch live data (weather, holidays, etc.) or Slack data (channels, messages etc) and renders responses as Slack Block Kit UI.

✨ Originally built for the Slack Agent Builder Challenge Hackathon c.2026

Responsible agentic behavior is enforced.

Architecture

flowchart LR
     subgraph RTS["REAL TIME SEARCH"]
         direction LR
         USERS["Users"] --- CHANNELS["Channels"] --- MSGS["Messages"] --- FILES["Files"]
         CHANNELS -.->|fallback| CH["conversations.history"]
     end

     subgraph S1["SLACK"]
         DM["Messages / Mentions"]
         INT["Button Clicks / Shortcuts"]
     end

     subgraph CF["CLOUDFLARE WORKERS"]
         direction LR

         subgraph R["ROUTING"]
             ENTRY["HTTP Handler"] --> ROUTE["Route Dispatcher"]
         end

         subgraph C["CORE SERVICES"]
             REACT["Event Handler"]
             QUEUE["Queue Consumer"]
             STATE["State Manager"]
             SLACK["Slack Gateway"]
             TOOLS["Tool Executor"]
             GENNY["Stream Parser"]
         end

         subgraph A["AI AGENTS"]
             GREET["Greeter β€” Llama 3B"]
             MAIN["Orchestrator β€” Qwen 30B"]
             CREATOR["Block Creator"]
             EDITOR["Block Editor"]
         end

         subgraph P["PRESENTATION"]
             VIEWS["View Components"]
             JSXRUNTIME["JSX β†’ Block Kit"]
             BLOCKS["Block Parser"]
         end

         subgraph K["KNOWLEDGE"]
             PROMPTS["LLM Prompts & Docs"]
             KV[("Encrypted KV Store")]
         end
     end

     subgraph X["EXTERNAL"]
         SLACKAPI["Slack Platform API"]
     end

     DM --> ENTRY
     INT --> ENTRY
     ENTRY --> ROUTE
     ROUTE --> REACT
     ROUTE --> SLACK
     REACT --> GREET
     REACT --> QUEUE
     GREET -->|enqueue| QUEUE
     QUEUE --> MAIN
     MAIN --> TOOLS
     MAIN --> GENNY
     MAIN --> STATE
     MAIN --> SLACK
     TOOLS --> SLACKAPI
     TOOLS --> RTS
     RTS --> SLACKAPI
     MAIN --> VIEWS
     MAIN --> BLOCKS
     BLOCKS --> JSXRUNTIME
     JSXRUNTIME --> SLACKAPI
     SLACK --> SLACKAPI
     STATE --> KV
     MAIN --> PROMPTS

     style RTS fill:#7B1FA2,stroke:#4A148C,color:#fff
     style S1 fill:#4A154B,stroke:#3d0e40,color:#fff
Loading

Responsible AI

  • Messages are stored temporarily in encrypted form
  • All details are deleted on app removal/uninstall
  • Prompts specifically deny self-harm, bad faith behavior etc

Development

npm install
npm run dev           # wrangler dev
npm run deploy        # wrangler deploy

About

πŸ“ Boost your slack tasks, workflows, search and most importantly... your mood!

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages