# Setup Environment

> Set up the embedding model for semantic search. model2vec-rs downloads models automatically; use when build fails or model download issues occur.

- Skill: `majiayu000/setup-environment` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/setup-environment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/setup-environment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/setup-environment

---


# 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:

```bash
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

```bash
# 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):

```bash
glhf index --skip-embeddings
```

This enables FTS5 search but disables semantic/hybrid modes.