环境搭建 | 安装指南:CellOracle环境搭建踩坑记录

单细胞测序 、scRNA-seq高级分析、scATAC-seq、 R包开发、源码拆解、 测试、RNA-seq 、其它生信分析、 R语言 、Python 、环境配置 、文献分享 、 一只羊的碎碎念

引言

CellOracle 是一款强大的基因调控网络（GRN）分析与模拟工具，能够基于单细胞转录组数据构建细胞类型特异的调控网络，并进行计算机模拟转录因子扰动分析。本文将详细介绍 CellOracle 的完整安装过程，包括常见问题的排查与解决方案。

环境准备

系统要求

CellOracle 基于 Python 3.8 开发，同时在 Python 3.10 环境下通过了测试。需要注意的是，CellOracle 不支持 Python 2.7x 及 Python 3.5 以下版本。

安装方式

CellOracle 可通过 PyPI 安装，也可从其 GitHub 仓库下载源码 https://github.com/morris-lab/CellOracle 进行安装。考虑到软件依赖管理的复杂性，强烈建议在独立的 conda 环境中进行安装，以避免与其他软件的依赖冲突。

安装过程详解

第一步：创建独立环境

使用 micromamba（或 conda）创建全新的 Python 环境：

source /gss1/env_os7/micromamba.envmicromamba create -n celloracle python=3.10micromamba activate celloracle

第二步：安装基础依赖

在尝试直接安装 CellOracle 时，可能会遇到 velocyto构建失败的问题，错误信息显示 ModuleNotFoundError: No module named 'numpy'。这是因为 velocyto的旧版本 setup.py在构建过程中需要预先导入 NumPy，而 pip 的临时构建环境尚未安装该依赖。

为解决这一问题，需要先手动安装核心依赖：

micromamba install numpy scipy cython numba matplotlib scikit-learn h5py click pysam llvm louvain

第三步：解决 velocyto 安装问题

velocyto是 CellOracle 的重要依赖，其安装过程较为复杂，主要面临两个挑战：

挑战一：构建隔离环境缺少 NumPy

直接运行 pip install celloracle时，pip 会创建干净的临时构建环境来编译 velocyto，但该环境不包含 NumPy。解决方案是使用 --no-build-isolation参数，让 pip 在当前环境中寻找已安装的依赖：

pip install --no-build-isolation velocyto

挑战二：Meson 构建系统要求

如果上述命令仍报错，提示 Cannot import 'mesonpy'或缺少 ninja，则需要更新构建工具链：

pip install --upgrade pip setuptools wheelpip install meson-python

挑战三：编译器版本兼容性

在高性能计算集群环境中，默认的 GCC 版本可能过低，导致编译失败。需要切换到较新的 GCC 版本：

source /gss1/env_os7/gcc_v12.2.0.envpip install -U --no-deps --no-build-isolation velocyto==0.17.17

第四步：安装 CellOracle 及其余依赖

在成功安装 velocyto后，安装 CellOracle 指定的依赖版本：

micromamba install -y -c conda-forge -c bioconda \  numpy=1.26.4 scipy cython numba "matplotlib<3.7" \  scikit-learn h5py click pysam llvm louvain pandas=1.5.3

随后安装 CellOracle 本体：

pip install celloracle

若网络状况不佳，可使用国内镜像加速：

pip install celloracle -i https://pypi.tuna.tsinghua.edu.cn/simple \  --trusted-host pypi.tuna.tsinghua.edu.cn

第五步：补充缺失依赖

安装完成后，若运行时提示缺少某些模块（如 pyarrow、pyzmq、htseq等），可使用 micromamba 逐一补充：

micromamba install pyarrowmicromamba install pyzmqmicromamba install htseq

第六步：解决 pkg_resources 兼容性问题

导入 CellOracle 时，若出现 ModuleNotFoundError: No module named 'pkg_resources'错误，是由于 setuptools 版本过高导致。降级至 59.8.0 版本即可解决：

pip install setuptools==59.8.0

安装验证

完成上述步骤后，通过以下命令验证安装是否成功：

import celloracle as coprint(co.__version__)

若顺利导入并输出版本号，则说明安装成功。首次导入时可能会显示一些关于 motif 分析工具的警告信息（如 MEME、Homer 等未找到），这些属于可选依赖，不影响核心功能的正常使用。

常见问题汇总

结语

CellOracle 的安装过程虽然涉及较多依赖和潜在的兼容性问题，但只要按照正确的顺序和环境配置进行操作，便可顺利完成。建议始终在独立的 conda 环境中进行安装，并优先使用 conda/micromamba 管理依赖，以最大程度避免版本冲突。安装完成后，即可进入后续的 GRN 构建与模拟分析阶段。