Install / setup
Structure
A Beaker install consists of the following:
- A Jupyter kernel (
beaker-kernel
) - A Jupyter server (
beaker-server
) (optional but recommended) - LLM integration (
archytas
) (optional) - Custom contexts (
contexts
) (optional)
Installing the kernel
Beaker-kernel can be installed as a normal Python package via pip, by using Hatch, or as a docker image.
python (local)
Normal installation:
$ pip install .
Dev installation:
$ pip install -e .
During pip install, the kernel is automatically installed in the proper location in your development environment.
Dev setup
This package is bundled with a basic development UI for development and testing, wrapped in a docker image
To get started run this command:
$ make dev-install
This will ensure that all prerequisites are installed and ready for use, but you will need to update the .env file with your OpenAI/GPT API key to use the LLM.
To connect to the Terarium data service, you will need to update the .env file with the url of a running instance.
Once you have set up the environment and added your keys you can start the dev server by running:
$ make dev
This will start the Jupyter service and launch a specialized notebook interface in your browser similar to if you ran $ jupyter notebook
normally.
Adding python dependencies/updating requirements
The python requirements are maintained by Hatch and are defined in the pyproject.toml file.
Please see the Hatch dependency documentation for more details.