botpress/botpress

Botpress is a platform for building chatbots and AI assistants that use large language models from OpenAI. A chatbot here means a software program that talks to people in natural language, for example on a company website or messaging app. Botpress as a product is offered as a cloud service at botpress.com, and this repository holds the open-source pieces that surround that cloud platform. The README explains that the repository contains four kinds of code. There is an integrations folder with all of Botpress's public integrations, which are connectors that hook the chatbot up to outside services like messaging platforms. There is a devtools section with the command line interface, the SDK, and the API client used to build and deploy bots. There is a bots folder with example bots written entirely as code rather than through the visual editor. A plugins section is listed but marked as coming soon. Integrations are written using the Botpress CLI, installed globally through npm, yarn, or pnpm. Running bp init scaffolds a new integration from a template, with one file describing what the integration does and another holding the implementation. The bp deploy command publishes the integration to a user's workspace, and adding the visibility public flag publishes it for everyone on the Botpress Hub. The bots folder is described as code-only bots that use the same client, SDK, and CLI. The README is explicit that this is not the recommended way to build bots and is not a replacement for the Botpress Studio, but it can be useful for developers who want full programmatic control, and the Botpress team itself uses these primitives internally. Local development requires Git, Node.js, and the pnpm package manager, with a Microsoft Visual C++ redistributable on Windows. The repository is cloned, pnpm install pulls dependencies, and pnpm run build compiles all packages. Everything in the repository is released under the MIT License.