beatrina
v1.0.1
Published
Beatrina is a modern, powerful, feature-rich integrated development environment (IDE) for R, Python, and JavaScript.
Readme
Beatrina
Beatrina is a modern, powerful, feature-rich integrated development environment (IDE) for R, Python, and JavaScript.
It provides a unified environment for interactive computing, scientific programming, data analysis, and reproducible research. Beatrina runs locally on your computer, providing direct access to your code, computational environment, data, and installed packages.
Beatrina supports R, Python, and JavaScript notebooks, with computation performed locally on your machine.
Installation
Beatrina requires Node.js 22 or later and R.
npm install -g beatrina
beatrinaOn first launch, Beatrina checks for the required R packages:
- jsonlite
- knitr
- evaluate
If any are missing, Beatrina offers to install them.
Command-Line Interface
beatrina doctorReports the detected development environment, including Node.js, R, required R packages, Python, and the latest Beatrina version available through npm.
beatrina python setupCreates the Python interpreter Beatrina manages (~/.beatrina/python, a virtual environment with ipykernel, pandas and matplotlib; --minimal installs ipykernel alone) from the newest Python 3.9 or later on the machine. Run it once when beatrina doctor reports no Python with ipykernel. To use another interpreter instead, set BEATRINA_PYTHON to its path, or keep a .venv beside your document.
beatrina statusDisplays active Beatrina sessions.
beatrina stopStops the active Beatrina session.
beatrina shortcutCreates an application icon and configures Open With integration for .qmd and .Rmd files.
beatrina checkRuns the Beatrina acceptance checks on the current machine.
beatrina upgradeInstalls the latest version of Beatrina from npm.
beatrina --versionDisplays the installed Beatrina version.
Upgrading
When Beatrina starts, it periodically checks npm for a newer version and reports its availability in the terminal and in the notebook.
The available update information can also be found in the notebook under:
- Info → Build
- Tools ▾ → Doctor
To upgrade:
beatrina upgradeor:
npm install -g beatrina@latestRunning sessions continue with the version they were started with. Restart the session from:
- Session ▾ → Restart
or restart Beatrina from the terminal:
beatrina stop
beatrinaYour documents, R packages, and settings are preserved during an upgrade.
To disable the periodic update check:
BEATRINA_NO_UPDATE_CHECK=1Uninstallation
npm uninstall -g beatrinaLicense
Beatrina is distributed under the Carm Research License v1.4, provided in the LICENSE file.
The license permits free use for research, teaching, and personal learning. Commercial use requires a paid license.
For commercial licensing, visit https://saqr.me or contact [email protected].
The NOTICES file lists the third-party components included with Beatrina and their respective license terms.
