All platforms
| Platform | File | Size | Install |
|---|---|---|---|
| Desktop app with the command line tool | |||
| macOS Apple silicon | Biorouter-1.92.1-arm64.dmg |
Open it and drag Biorouter to Applications. | |
| macOS Intel | Biorouter-1.92.1-x64.dmg |
Open it and drag Biorouter to Applications. | |
| Windows Installer | Biorouter-Setup-1.92.1.exe |
Run the installer. | |
| Windows Archive | Biorouter-win32-x64-1.92.1.zip |
Unzip it and run Biorouter.exe. | |
| Linux Debian, Ubuntu | biorouter_1.92.1_amd64.deb |
sudo apt install ./biorouter_1.92.1_amd64.deb |
|
| Linux Fedora, RHEL | Biorouter-1.92.1-1.x86_64.rpm |
sudo dnf install ./Biorouter-1.92.1-1.x86_64.rpm |
|
| Command line only for Linux servers, HPC and containers | |||
| Linux Debian, Ubuntu | biorouter-cli_1.92.1_amd64.deb |
sudo apt install ./biorouter-cli_1.92.1_amd64.deb |
|
| Linux Fedora, RHEL | biorouter-cli-1.92.1-1.x86_64.rpm |
sudo dnf install ./biorouter-cli-1.92.1-1.x86_64.rpm |
|
Older versions and the files the app uses to update itself are on the releases page. For help installing, ask on the Biorouter Slack.
After you install
Three steps
-
01
Open the app.
Start Biorouter from Applications, the Start menu or your app launcher.
-
02
Connect a model.
Pick a provider on the Welcome screen, or later in Settings → Models. Llama Server, on the Local tab, needs no account or key. UCSF users pick Versa API Azure or Versa API Bedrock on the Institutional tab.
-
03
Ask a question.
Type in the message box and press Enter.
Getting started
Command line and servers
The biorouter tool
The command line tool
ships with the app.
The first time you open the app, it offers to install the tool: press Install on the Biorouter CLI card. After that, biorouter works in any terminal.
On a Linux server, HPC node or container, install a command line only package instead. It holds the biorouter tool, the biorouterd daemon and the web interface, without the desktop app.
- To install it yourself on macOS
/Applications/Biorouter.app/ Contents/ Resources/ bin/ biorouter setup-path - On Windows, use the Install card, or run
resources\in the folder you unzipped.bin\ biorouter.exe setup-path - Choose the model before you serve. A browser session cannot change it.
biorouter configure- Use Biorouter from a browser, then open the address it prints
biorouter serve- Check the setup and optional prerequisites
biorouter doctor
Requirements
What each build runs on
macOS
Apple silicon and Intel. Builds are signed with UCSF's Developer ID and notarized by Apple.
Windows
x64. The installer upgrades an existing install in place.
Linux
x86_64. The desktop packages need Debian 12, Ubuntu 22.04, Fedora or RHEL 9 or newer. Local models need Debian 12 or Ubuntu 22.04 or newer. The command line packages also run on Debian 11.
Community
Join the Biorouter Slack.
Get help installing, report problems, and ask the researchers and developers who use Biorouter.