SKILL: Bohrium Project Management

Overview

Manage projects on the Bohrium platform. Prefer bohr CLI; fall back to the API only for operations the CLI doesn't support (member management, cost limits, renaming).

Projects are the organizational containers for Nodes, Jobs, Images, and Datasets — and the basic unit for team collaboration and cost management.

Authentication

"bohrium-project": {
  "enabled": true,
  "apiKey": "YOUR_ACCESS_KEY",
  "env": {
    "ACCESS_KEY": "YOUR_ACCESS_KEY"
  }
}

Prerequisites: Install bohr CLI

# macOS
/bin/bash -c "$(curl -fsSL https://dp-public.oss-cn-beijing.aliyuncs.com/bohrctl/1.0.0/install_bohr_mac_curl.sh)"

# Linux
/bin/bash -c "$(curl -fsSL https://dp-public.oss-cn-beijing.aliyuncs.com/bohrctl/1.0.0/install_bohr_linux_curl.sh)"

source ~/.bashrc  # or source ~/.zshrc
export PATH="$HOME/.bohrium:$PATH"

List Projects

bohr project list               # Table format
bohr project list --json        # JSON format
bohr project list --csv         # CSV format

JSON fields:

Create Project

bohr project create -n "my-experiment"
bohr project create -n "my-experiment" -m 5000          # Monthly cost limit
bohr project create -n "my-experiment" -t 10000         # Total cost limit

Parameters:

Delete Project

bohr project delete 154

> Warning: Deleting a project is irreversible — all jobs and images under the project will be removed and cannot be recovered.

Roles & Permissions

Bohrium projects have 3 roles:

Permission Matrix

> Important: Costs incurred by members are charged directly to the project creator's wallet balance.

Budget Management

Project Budget

Creators and admins can set the project's total budget (optional). If not set, the default is "unlimited".

When the project's total cost exceeds the budget, members cannot submit new jobs or start new nodes.

Member Budget

Individual spending limits can be assigned per member:

• "Even split": Divide the project budget equally among all members
• "Uniform": Set the same limit for each member
• Manual: Set different limits for different members

Set project cost limit via API:

requests.post(f"{BASE}/set_cost_limit", headers=HEADERS_JSON,
    json={"projectId": 154, "costLimit": 5000})

Shared Resources

Shared Disk (/share)

Each project has 1TB of free shared storage with read/write access for all members.

• Access the /share directory via Web Shell or the file management page
• Data persists after node release
• Additional capacity can be purchased

Shared Images

All project members can see custom images created by other members in the Bohrium Image Center, making it easy to share development environments.

Billing

• Account balance is deducted every 5 minutes
• Warning email sent when balance drops below threshold (default ¥100)
• Cannot submit new jobs when balance reaches zero

Quotas

> Contact Bohrium support to increase quotas.

API Supplement (CLI Unsupported)

The following operations are not covered by the bohr CLI and require the API:

import os, requests

AK = os.environ.get("ACCESS_KEY", "")
BASE = "https://open.bohrium.com/openapi/v1/project"
HEADERS = {"accessKey": AK}
HEADERS_JSON = {**HEADERS, "Content-Type": "application/json"}

# Detailed project list (with cost, member count, etc.)
r = requests.get(f"{BASE}/list", headers=HEADERS)
# Returns: {items: [{id, name, totalCost, monthCost, userCount, projectRole, ...}]}

# Lightweight project list (id + name only)
r = requests.get(f"{BASE}/lite_list", headers=HEADERS)

# Rename project
requests.post(f"{BASE}/set_name", headers=HEADERS_JSON,
    json={"projectId": 154, "name": "new-name"})

# Set cost limit
requests.post(f"{BASE}/set_cost_limit", headers=HEADERS_JSON,
    json={"projectId": 154, "costLimit": 5000})

# View project members
r = requests.get(f"{BASE}/154/users", headers=HEADERS)
# Returns: {items: [{userId, userName, email, projectRole, cost, ...}]}

# Add member (by email)
requests.post(f"{BASE}/add_user", headers=HEADERS_JSON,
    json={"projectId": 154, "email": "user@example.com"})

# Remove member
requests.post(f"{BASE}/del_user", headers=HEADERS_JSON,
    json={"projectId": 154, "userId": 12345})

# Promote/demote admin
requests.post(f"{BASE}/manager/add", headers=HEADERS_JSON,
    json={"projectId": 154, "userId": 12345})
requests.post(f"{BASE}/manager/del", headers=HEADERS_JSON,
    json={"projectId": 154, "userId": 12345})

# Recover deleted member
requests.put(f"{BASE}/154/recovery_user", headers=HEADERS_JSON,
    json={"userId": 12345})

Project Role API Values

Unavailable Endpoints

The following endpoints are not accessible via openapi accessKey (return 404):

Troubleshooting