安装指南

本页面将指导您安装 Bohrium OpenAPI Python SDK。

系统要求

Python 3.7 或更高版本
pip 包管理器

安装方法

使用 pip 安装（推荐）

最简单的方式是使用 pip 直接从 PyPI 安装：

pip install bohrium-sdk

如果您使用的是 Python 3，可能需要使用 pip3：

pip3 install bohrium-sdk

从源码安装

如果您想从源码安装最新版本或进行开发，可以按以下步骤操作：

# 克隆仓库
git clone https://github.com/dingzhaohan/bohrium-openapi-python-sdk.git
cd bohrium-openapi-python-sdk

# 安装依赖
pip install -r requirements.txt

# 安装SDK
pip install -e .

开发模式安装

如果您想参与SDK的开发，建议使用开发模式安装：

git clone https://github.com/dingzhaohan/bohrium-openapi-python-sdk.git
cd bohrium-openapi-python-sdk
pip install -e ".[dev]"

验证安装

安装完成后，您可以验证安装是否成功：

python -c "import bohrium; print(bohrium.__version__)"

或者：

python -c "from bohrium import Bohrium; print('安装成功!')"

依赖包

SDK主要依赖以下包：

httpx - 用于HTTP请求
pyhumps - 用于命名转换
typing_extensions - 类型扩展支持
anyio - 异步IO支持
requests - HTTP库
tqdm - 进度条显示
distro - 系统信息

这些依赖会在安装SDK时自动安装。

故障排除

常见问题

问题: 安装时出现权限错误

解决方案: 使用 --user 标志安装到用户目录：

pip install --user bohrium-sdk

问题: Python版本不兼容

解决方案: 确保您的Python版本 >= 3.7。可以使用以下命令检查：

python --version

问题: 依赖包冲突

解决方案: 建议使用虚拟环境：

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境 (Windows)
venv\Scripts\activate

# 激活虚拟环境 (Linux/Mac)
source venv/bin/activate

# 安装SDK
pip install bohrium-sdk

下一步

安装完成后，请继续阅读快速开始开始使用SDK。