botpress/botpress

The open-source hub to build & deploy GPT/LLM Agents ⚡️

Botpress Cloud – Open‑source platform for building AI‑powered chatbots

What it is – Botpress is a developer‑focused platform that lets you create, deploy, and manage chatbots and conversational assistants. The core of the system is a set of open‑source packages (CLI, SDK, client) plus a collection of ready‑made integrations (e.g., Slack, Discord, WhatsApp) that can be published to the Botpress Hub. The platform is tightly integrated with OpenAI models, so the bots you build can use large language models for natural‑language understanding and generation.

Key parts of the repository

Folder / Package Purpose
integrations/ Source code for all public integrations that can be installed into a Botpress workspace. Each integration includes a TypeScript definition (integration.definition.ts) and implementation (src/index.ts).
bots/ Example bots written purely with the SDK/CLI – useful as reference code for developers who prefer a code‑first approach rather than the visual Botpress Studio.
packages/cli The @botpress/cli tool – command‑line interface for creating, building, deploying, and managing bots, integrations, and (future) plugins.
packages/sdk The @botpress/sdk library – TypeScript SDK that defines the primitives used to write integrations and bots.
packages/client The @botpress/client library – type‑safe HTTP clients for calling Botpress Cloud APIs.

How it works

  1. Create a new integration or bot with bp init (provided by the CLI).
  2. Develop the logic in TypeScript using the SDK (@botpress/sdk).
  3. Deploy to your Botpress Cloud workspace with bp deploy.
  4. Publish integrations publicly (bp deploy --visibility public) so they appear on the Botpress Hub for any user.

Typical use‑cases

  • Building customer‑support assistants that query OpenAI for answers and route to human agents when needed.
  • Adding conversational interfaces to SaaS products (e.g., Slack bots, website chat widgets).
  • Creating internal tooling bots that automate workflows via APIs.
  • Extending the platform with custom integrations for niche services (CRM, ticketing, IoT, etc.).

Getting started

# Install the CLI globally (npm, yarn or pnpm)
npm install -g @botpress/cli   # or yarn global add @botpress/cli

# Initialise a new integration or bot
bp init

# After writing your code, deploy to your Botpress Cloud workspace
bp deploy

The README points to full documentation at https://docs.botpress.cloud and a community Discord for help.

License – All packages in this repo are released under the MIT License, allowing free use, modification, and commercial distribution.


Botpress Cloud is an open‑source, AI‑enabled chatbot development platform that provides a CLI, SDK, and a marketplace of integrations to help developers build and ship conversational assistants quickly.

Related

  • Project
  • Project
  • Project
  • Project
  • Project