Skip to content
Get packs

Botpress

Open-source tools to build and deploy chatbots and LLM agents, centred on Botpress Cloud.

GitHub Download v12.30.9
Stars
15k
Forks
2.3k
Licence
MIT
Language
TypeScript
Last update
6 days ago
Type
Dev tool

What it is

This repository holds the open-source parts of Botpress Cloud: integrations, developer tools (a CLI, an SDK and an API client), and some example bots written as code. Botpress is described as a platform for building chatbots and assistants powered by OpenAI. The README says the visual Botpress Studio is the recommended way to build bots, and the code-based approach is mainly for experienced developers.

  • Scaffold a new integration from a template with the bp init command
  • Deploy an integration to your Botpress workspace with bp deploy
  • Make a finished integration public on the Botpress Hub with bp deploy --visibility public
  • Study example bots written as code in the /bots folder

Great for

  • Developers who want to write integrations and bots as TypeScript code using the Botpress CLI and SDK
  • Teams already using Botpress Cloud who want to publish or deploy their own integrations
  • Developers who want to read example bots built only with the SDK and CLI

Not ideal for

  • Non-programmers who want a no-code chatbot builder: the README says the Studio is recommended over building bots as code
  • People looking for the on-premise Botpress v12 product: the README sends those users to a separate v12 repository
  • Anyone needing a self-contained local chatbot: the README focuses on Botpress Cloud workflows and does not describe a standalone self-hosted setup
Step-by-step guide: how to use BotpressInstall, first run, examples, tips and FAQs
Botpress alternativesBotpress vs LangChainBotpress vs ComposioBotpress vs Portkey AI GatewayBotpress vs Prompt flowBotpress vs Desktop Commander

How to get it

  1. 1

    Install with a package manager

    You'll need: Node.js · pnpm · git

    Install the Botpress CLI (npm)

    npm install -g @botpress/cli

    Create a new integration

    bp init

    Deploy an integration to your workspace

    bp deploy

    Clone and build the repository from source

    git clone https://github.com/botpress/botpress.git
  2. 2

    Run it

    • Install the Botpress CLI with npm, yarn or pnpm
    • Run bp init in an empty directory and pick a template
    • Edit integration.definition.ts and src/index.ts
    • Run bp deploy to push the integration to your workspace
  3. 3

    Get the most out of it

    • Read the SDK and CLI docs linked from the README for the full command reference
    • Use bp deploy --visibility public only when you are ready to share, since public versions cannot be updated again
    • Look at the /integrations folder for existing public integrations to learn from
    • Join the Discord community for faster answers than GitHub issues, per the README

Downloads

Source code (.zip)master branch · straight from GitHubRelease v12.30.9Release notes and sourceOfficial website & docsbotpress.com

Strengths

  • Released under the MIT license, so the code can be reused and modified freely
  • Uses TypeScript and a typed SDK and API client, which helps catch errors early
  • Includes a CLI for the full integration workflow: create, deploy and publish

Trade-offs

  • The README marks plugins as coming soon, so that part is not yet available
  • Code-first bot building is described by the authors as not the recommended route for most users
  • Setup and terminology depend on the Botpress Cloud service, so the project is tied to that platform

How it compares

ProjectStarsTypeLevelUpdatedBest for
botpress (this)15kDev toolintermediate6 days agoDevelopers who want to write integrations and bots as TypeScript code using the Botpress CLI and SDK
langchain149kFrameworkintermediate4 days agoPython developers building LLM-powered applications
OpenHands92.5kAppintermediate4 days agoDevelopers who want coding agents running on a server while their laptop is off
repomix29.1kCLIbeginner4 days agoDevelopers who want to ask an AI assistant questions about a whole project
promptflow11.3kDev toolintermediate6 days agoTeams with existing Prompt flow applications that need to keep running until migration
shell_gpt12.3kCLIbeginner4 months agoDevelopers who often forget shell or command-line syntax

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.