beaker-py is a lightweight, standalone, pure Python client for Beaker.


🪶 Lightweight

  • Minimal dependencies.

  • Only pure-Python dependencies.

  • Communicates directly with the Beaker server via HTTP requests (Beaker CLI not required).

💪 Robust

  • Automatically retries failed HTTP requests with exponential backoff.

  • Runtime data validation.

  • High test coverage.

📓 Exhaustively-typed and documented

  • Thorough data model for all input / output types.

  • Every expected HTTP error from the Beaker server is translated into a specific exception type.



beaker-py is developed and maintained at the Allen Institute for Artificial Intelligence (AI2). AI2 is a non-profit institute with the mission to contribute to humanity through high-impact AI research and engineering.

To learn more about who specifically contributed to this codebase, see our contributors page.


beaker-py is licensed under Apache 2.0. A full copy of the license can be found on GitHub.

Indices and tables#