At a Glance:
Botpress Cloud is an open-source platform for building AI chatbots and assistants using its CLI, SDK, and public integrations, with a programmable "bots as code" approach available for developers who need full control over their bot's implementation.
Overview:
Botpress Cloud is a developer-focused platform for building next-generation chatbots and assistants powered by large language models like OpenAI. It provides a dedicated Studio for bot building, but this repository specifically houses its open-source components: a CLI for project management, an SDK for building custom integrations, and a type-safe API client. It also introduces a "bots as code" method, allowing experienced developers to programmatically build bots using only the SDK and CLI, a lower-level approach compared to the standard Botpress Studio. The platform's public Hub allows developers to share their custom integrations with the community.
Key Decision Points:
Bot Building Approach: The recommended method is through the Botpress Studio, but it offers a distinct, code-first alternative for developers who prefer building bots programmatically with the SDK and CLI.
Integration Ecosystem: New integrations are developed and deployed locally via the CLI, starting as private to a user's workspace before they can be optionally published publicly to the Botpress Hub.
Public Integration Stability: Once a specific version of an integration is made public on the Hub, it becomes immutable and cannot be updated, which is crucial for dependency management.
Tooling Suite: The platform provides a trio of developer tools: a CLI for deployment and management, an SDK for integration creation, and a type-safe client for API consumption.
Core Features:
Programmatic Bot Development: Ability to create complete bots "as code" using the SDK and CLI, bypassing the visual Botpress Studio for a more developer-centric workflow.
Custom Integration SDK: A dedicated SDK (
@botpress/sdk) and CLI scaffolding (bp init) for building, defining, and implementing new integrations from templates.Private and Public Integration Deployment: Developers can deploy integrations privately to their workspace for testing and then explicitly make them public on the Hub using the CLI.
Type-safe API Client: A provided client package (
@botpress/client) ensures type safety when consuming the Botpress APIs.Devtools Monorepo: All core developer tools, including the CLI, client, and SDK, are maintained as open-source packages within this single repository.
Use Cases:
Developers building custom chatbots: Experienced developers who want to create complex, custom bots using a code-first approach rather than a visual interface.
Community contributors extending Botpress: Developers looking to build and share new integrations on the Botpress Hub, such as connecting to external services.
Teams managing bot infrastructure as code: Teams that prefer to version, manage, and deploy bot logic programmatically alongside their integration configurations.
Open-Source Alternative Value:
As an open-source platform under the MIT license, Botpress Cloud offers developers complete access to its core tooling—the CLI, SDK, and API client—for building AI-powered assistants. Its value for developers lies in the programmable "bots as code" method, which provides a transparent, code-based way to create and manage bots outside the standard studio environment. The ability to build, deploy, and share integrations through its public Hub system offers a transparent and community-extensible alternative to closed, proprietary chatbot ecosystems.
