Skip to content

Is BlackBull right for your project?

BlackBull serves HTTP/1.1, HTTP/2, WebSocket, gRPC and an MQTT 5 broker in one asyncio runtime. See Architecture for protocol ownership and Conformance for tested coverage.

Before choosing it, check these constraints:

  • The API is Early Alpha and may change between MINOR releases.
  • It requires asyncio; Trio is unsupported.
  • Authentication, rate limiting and database integration are application or extension responsibilities.
  • The MQTT broker has one worker owner and keeps state in memory; it is not a persistent or clustered message bus. See MQTT limitations.
  • OpenAPI documents the supported schema surface; do not assume full body-model or security-scheme inference.
  • Fault injection covers HTTP/1.1 and HTTP/2, with an HTTP/1.1 differential oracle; it is not a fault injector for every protocol.

For deployment examples, see Edge inference serving and Protocol translation. Check Known limitations before relying on a protocol feature.