Install Burette

Burette supports macOS 12 and later.

Homebrew

Install from the Burette tap:

brew tap SergeiNikolenko/burette
brew install --cask burette

Check the installed cask version:

brew info --cask SergeiNikolenko/burette/burette

GitHub Releases

You can also install manually:

1. Open the latest release .
2. Download the Burette-<version>.dmg or Burette-<version>.zip file.
3. Open the DMG or unzip the archive.
4. Move Burette.app to your Applications folder.
5. Open Burette once from Applications.

First launch

Open Burette.app once after installation. This gives macOS a chance to register the app bundle and Finder Quick Look extension.

The current 2.3.8 public release is ad-hoc signed and is not Apple-notarized. macOS Gatekeeper may require you to approve the first launch manually in System Settings > Privacy & Security.

If Finder previews do not appear after install, open Burette’s command palette and run Reset Quick Look. Open Logs Folder and Export Diagnostics are available there as well.

Codex plugin and local MCP

The optional Codex integration lives in the same Burette repository  as the app. It bundles workflow skills with typed MCP tools for opening, observing, and controlling a local molecular workspace.

Clone the repository and run the plugin installer:

git clone https://github.com/SergeiNikolenko/Burette.git
cd Burette
bun run install:plugin

Restart Codex after installation, then mention @Burette or select Burette from Plugins. See Codex Plugin and MCP for the tool surface, security boundaries, and source links.

Optional local calculation engines

The Burette application does not bundle xTB, CREST, or PRISM. Install only the engines needed for your local workflow:

pixi global install xtb
pixi global install crest
uv tool install prism_pruner

Check each executable before a production calculation, then use the matching runtime check in the desktop inspector. See xTB calculations and CREST and PRISM.