Beaker: the AI-first coding notebook
Beaker is a next generation coding notebook built for the AI era. Beaker seamlessly integrates a Jupyter-like experience with an AI agent that can be used to generate code and run code on the user's behalf. The agent has access to the entire notebook environment as its context, allowing it to make smart decisions about the code to generate and run. It can even debug itself and fix errors so that you don't have to. When the agent wants to use a library that isn't installed, it can even install it automatically.
Beyond that, Beaker solves one of the major challenges presented by coding notebooks--it introduces a true undo mechanism so that the user can roll back to any previous state in the notebook. Beaker also lets you swap effortlessly between a notebook style coding interface and a chat style interface, giving you the best of both worlds. Since everything is interoperable with Jupyter, you can always export your notebook and use it in any other Jupyter-compatible environment.
Beaker is powered by Archytas, our framework for building AI agents that can interact with code and advanced users can generate their own custom agents to meet their specific needs. These agents can have custom ReAct toolsets built in and can be extended to support any number of use cases.
We like to think of Beaker as a (much better!) drop in replacement for workflows where you'd normally rely on Jupyter notebooks and we hope you'll give it a try and let us know what you think!
Getting Started
Getting Beaker up and running is easy! All you need to do is install the Beaker with:
pip install beaker-kernel
Next, you'll run beaker config update to set up your configuration. This will create a beaker.conf file in your home directory's .config folder. You can leave everything as the default except for the LLM_SERVICE_TOKEN which you'll need to set to your OpenAI API (or other LLM provider) key.
Now that you've got things installed and set up, just simply run:
beaker notebook
Your notebook server will start up and Beaker will be ready to use at localhost:8888.
Quick demo
Here is a quick demo of using Beaker to interact with a free weather API, fetch some data, perform some data transformations and a bit of analysis. This is really just scratching the surface of what you can do with Beaker, but it gives you a sense of the kinds of things it can do.
Want to know more?
There is a lot more to Beaker than what we've covered here, so we've put together more detailed docs that cover how to customize and extend Beaker in more detail. These include information on how to build your own custom contexts, toolsets, and subkernels to make Beaker meet your specific needs and usecases. It also gets into the basics of using the Beaker TypeScript SDK to build your own custom front-ends around Beaker.
2 maintainers
Metadata
2 maintainers
Release files for beaker-kernel 1.14.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| beaker_kernel-1.14.0.tar.gz | 2.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| beaker_kernel-1.14.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.7 MB
Release files / beaker_kernel-1.14.0.tar.gz
| Download URL | beaker_kernel-1.14.0.tar.gz |
|---|---|
| Size | 2.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3d5455d832b56492dbad8830c8645b0e282ade1bd4f93b1e0ea7ef2597ed949b
|
|
BLAKE2b-256 checksum How to use checksums |
d100c5c655a070fb5d195500c9bc8504212b2c96e83b4c824487cc3f0b22ef0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2025.
Transparency logRelease files / beaker_kernel-1.14.0-py3-none-any.whl
| Download URL | beaker_kernel-1.14.0-py3-none-any.whl |
|---|---|
| Size | 2.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
54df0fe66f00574951ac81e85075fb158a2b82f20da538fa55aae201face279e
|
|
BLAKE2b-256 checksum How to use checksums |
763586e361215578649bbf0cff88c6979a2410dede0be39311d3570ec6821f69
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 5, 2025.
Transparency log
