setup-environment
为语义搜索设置嵌入模型。model2vec-rs 自动下载模型;在构建失败或模型下载问题出现时使用。
📖 中文导读:为语义搜索设置嵌入模型。model2vec-rs 自动下载模型;在构建失败或模型下载问题出现时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: setup-environment description: Set up the embedding model for semantic search. model2vec-rs downloads models automatically; use when build fails or model download issues occur.
Environment Setup for Semantic Search
Instructions
glhf uses model2vec-rs with Potion-base-32M for embeddings. The model downloads automatically on first use.
Quick Setup
No manual setup required:
cargo build --release
./target/release/glhf index
The embedding model (~130MB) will download to the HuggingFace cache on first run.
Model Details
| Property | Value |
|---|---|
| Model | minishlab/potion-base-32M |
| Dimensions | 512 |
| Size | ~130MB |
| Cache Location | ~/.cache/huggingface/ |
Verify Setup
# Run embedding tests
cargo test embed -- --ignored
Common Issues
| Error | Solution |
|---|---|
Failed to load model |
Check internet connection, model will auto-download |
No space left |
Clear HuggingFace cache: rm -rf ~/.cache/huggingface/ |
Slow first run |
Normal - model downloads once, then cached |
Skip Embeddings
For text-only search (faster indexing, no model download):
glhf index --skip-embeddings
This enables FTS5 search but disables semantic/hybrid modes.