bohrium-code

AI research assistant for the Bohrium scientific computing platform. Drives jobs, datasets, images, papers, and knowledge bases from the terminal, wired directly to open-platform APIs.

Installable as the bohr CLI.

Install

npm install -g @dptech-corp/bohrium-code

Postinstall downloads a matching ripgrep binary for fast code search. Skip with BOHR_SKIP_POSTINSTALL=1 if you already have rg on PATH.

Supported platforms: Linux (x64/arm64), macOS (x64/arm64), Windows (x64).

If bohr: command not found after a user-prefix install, make sure the npm bin directory is on your PATH:

# common on macOS when using ~/.npm-global as prefix
export PATH="$HOME/.npm-global/bin:$PATH"

Quickstart

export BOHR_ACCESS_KEY=<your-key-from-bohrium.com>
bohr                             # interactive REPL
bohr -p "list my running jobs"   # one-shot print mode

Get an access key from your Bohrium profile page.

What's in the box

Tools exposed to the model, routed through the Bohrium open platform:

| Tool | What it does | |---|---| | BohrJob | list / view / submit / kill / log / download compute jobs | | BohrNode | list node types, check resource availability and pricing | | BohrDataset | list / create / commit / version datasets | | BohrImage | search public images, list private, build new images | | BohrProject | project listing, member management, cost limits | | PaperSearch | keyword, title, reference, journal, patent lookups | | PDFParser | parse PDFs into structured text/tables/figures/molecules | | MolSearch | molecular structure and molecule-aware paper search | | KnowledgeBase | literature sage: list, search, recall, upload PDFs | | BohrWebSearch | web search routed through the open platform | | BohrScholar / BohrWiki | scholar and wiki lookups | | Sandbox | ephemeral compute sandbox for bash/write/read | | VikingMemory | OpenViking persistent memory store |

Plus the general-purpose coding tools (Bash, Read, Edit, Write, Glob, Grep, Agent, TaskCreate, ...).

Environment

| Variable | Purpose | |---|---| | BOHR_ACCESS_KEY | Bohrium access key (required) | | BOHR_API_BASE_URL | Override open-platform base (default https://open.bohrium.com/openapi) | | BOHR_SKIP_POSTINSTALL | Set to 1 to skip the ripgrep download on npm install | | USE_BUILTIN_RIPGREP | Set to false to force using system rg at runtime |

Common workflows

Submit a DeePMD training job

bohr -p "submit a DeePMD training job in project 12345 on c12_m46_1 * NVIDIA V100 with my input folder ./data"

Upload a PDF into a knowledge base folder

bohr -p "upload ./paper.pdf into knowledge base folder 4567"

Parse a long paper (auto-pages past the 95 KB cap)

bohr -p "parse https://arxiv.org/pdf/2301.00001 and summarize methods + results"

Search datasets

bohr -p "find datasets in project 12345 containing DFT calculations"

Build from source

git clone https://github.com/deepmodeling/bohrctl
cd bohrctl
bun install
bun run build       # writes dist/cli.js
./dist/cli.js -p "hello"

Requires Bun ≥ 1.2.

Feedback / issues

Report issues at https://github.com/deepmodeling/bohrctl/issues.

License

See LICENSE.