# pip install sentence-transformers 失败记录

**时间**: 2026-07-12  
**会话**: `20260712_095150_28dd34`  
**环境**: Termux ARM64, Python 3.14

## 完整输出

```
$ pip install sentence-transformers 2>&1

ERROR: Cannot install sentence-transformers==0.2.6.1, ... because these 
package versions have conflicting dependencies.

The conflict is caused by:
    sentence-transformers 0.2.6.1 depends on torch>=1.0.1
    sentence-transformers 0.2.5.1 depends on torch>=1.0.1
    sentence-transformers 0.2.5 depends on torch>=1.0.1
    sentence-transformers 0.2.4.1 depends on torch>=1.0.1
    sentence-transformers 0.2.4 depends on torch>=1.0.1
    sentence-transformers 0.2.3 depends on torch>=1.0.1
    sentence-transformers 0.2.2 depends on torch>=1.0.1
    sentence-transformers 0.2.1 depends on torch>=1.0.1
    sentence-transformers 0.2.0 depends on torch>=1.0.1
    sentence-transformers 0.1.0 depends on torch>=1.0.1

Additionally, some packages in these conflicts have no matching 
distributions available for your environment:
    torch

To fix this you could try to:
1. loosen the range of package versions you've specified
2. remove package versions to allow pip to attempt to solve 
   the dependency conflict

ERROR: ResolutionImpossible
```

## 根因

PyTorch (`torch`) 官方只为以下平台提供预编译 wheel：
- Linux x86_64 (manylinux)
- macOS x86_64 / ARM64
- Windows x86_64

**Termux ARM64 (Android aarch64) 不在支持列表中。** pip 无法解析依赖 → 整个 sentence-transformers 装不上。

`sentence-transformers` 所有版本都硬依赖 `torch>=1.0.1`，无例外。

## 解决方案

切换到 ONNX Runtime（已在 Termux 上验证可用 v1.27.1）+ transformers tokenizer。

详见父 skill `android-ml-inference` 的 Step 3-4。