2. 前置条件与系统要求

在安装之前，先确认你的环境满足以下条件。omicOS 需要两样东西：omicos 二进制（程序本体）和 Python 分析环境（跑生信分析的引擎），外加一个云账户。

2.1 支持的操作系统与平台

omicos 提供六个平台的预编译二进制，覆盖主流系统：

关于 Linux： omicos 的 Linux 版本使用 musl 静态链接（而非 glibc/gnu），这样可以避免不同发行版 libc 版本差异带来的兼容性问题——一个二进制在 Ubuntu、CentOS、HPC 登录节点上都能跑。

2.2 安装方式

omicos 通过 npm 安装预编译二进制，只需要 Node.js ≥ 16：

npm 会根据你的系统自动下载上表中匹配的那个平台二进制，无需任何编译工具链。详见第 3 章。

2.3 Python 分析环境

omicos 自己只是个调度内核，真正跑 scanpy / omicverse 的是一个独立的 Python 环境（约 1 GB，包含 scanpy、omicverse 等生信包）。

• 推荐用 omicOS 自带的 omicos env setup 命令一键创建（底层用 uv 管理虚拟环境）。
• 也可以指向你已有的 conda / venv 环境。

详见第 4 章：配置 Python 分析环境。

注意： 如果不配置 Python 环境，omicos 守护进程能起来，但一旦你让它运行分析代码，kernel 会报 scanpy not found。这个错误是延迟出现的——启动时不报，运行分析时才暴露，所以请务必先配好环境。

2.4 omicOS 云账户

omicOS 的部分功能（智能体聊天、跨设备查看、图床、订阅分层）依赖云账户：

• 在 auth.omicos.cn 注册账户。
• 登录方式见第 5 章。

2.5 网络要求

• omicos 需要能 outbound 访问 auth.omicos.cn，用于登录、进程注册、同步。
• 默认只监听 127.0.0.1（本机回环），不对外开放端口；远程访问通过 SSH 端口转发或云端中继实现，详见远程部署配方。

检查清单

开始安装前，确认：

• [ ] 操作系统在上面六个平台之列
• [ ] 已安装 Node.js ≥ 16
• [ ] 已在 auth.omicos.cn 注册账户
• [ ] 机器能访问外网（至少能连到 auth.omicos.cn）

满足后，进入第 3 章：通过 npm 安装。