File size: 2,294 Bytes
6c9ce7f
3385c94
6c9ce7f
2fb50bc
6c9ce7f
 
 
 
 
 
2fb50bc
6c9ce7f
 
 
 
 
2fb50bc
 
 
6c9ce7f
2fb50bc
6c9ce7f
 
 
2fb50bc
6c9ce7f
2fb50bc
 
 
6c9ce7f
2fb50bc
 
 
 
 
 
6c9ce7f
2fb50bc
 
 
 
 
6c9ce7f
 
 
 
 
 
 
 
 
 
 
 
2fb50bc
 
 
6c9ce7f
2fb50bc
6c9ce7f
2fb50bc
 
 
 
 
6c9ce7f
 
 
 
2fb50bc
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
---
license: apache-2.0
language: [multilingual]
tags: [embeddings, gguf, ggml, text-embeddings, xlm-r, crispembed, ollama]
pipeline_tag: feature-extraction
base_model: telepix/PIXIE-Rune-v1.0
---

# pixie-rune-v1 GGUF

GGUF format of [telepix/PIXIE-Rune-v1.0](https://huggingface.co/telepix/PIXIE-Rune-v1.0) for use with [CrispEmbed](https://github.com/CrispStrobe/CrispEmbed) and [Ollama](https://ollama.com).

## Files

| File | Quantization | Size |
|------|-------------|------|
| [pixie-rune-v1-q4_k.gguf](https://huggingface.co/cstr/pixie-rune-v1-GGUF/resolve/main/pixie-rune-v1-q4_k.gguf) | Q4_K | 0 MB |
| [pixie-rune-v1-q8_0.gguf](https://huggingface.co/cstr/pixie-rune-v1-GGUF/resolve/main/pixie-rune-v1-q8_0.gguf) | Q8_0 | 0 MB |
| [pixie-rune-v1.gguf](https://huggingface.co/cstr/pixie-rune-v1-GGUF/resolve/main/pixie-rune-v1.gguf) | F32 | 0 MB |

**Recommended:** Q8_0 for quality (cos vs HF: cross-lingual OK), Q4_K for size (cross-lingual OK).

## Quick Start

### CrispEmbed
```bash
./crispembed -m pixie-rune-v1 "Hello world"
./crispembed-server -m pixie-rune-v1 --port 8080
```

### Ollama (with [CrispStrobe fork](https://github.com/CrispStrobe/ollama/tree/feat/xlmr-embedding))
```bash
echo "FROM pixie-rune-v1-q8_0.gguf" > Modelfile
ollama create pixie-rune-v1 -f Modelfile
curl http://localhost:11434/api/embed -d '{"model":"pixie-rune-v1","input":["Hello world"]}'
```

### Python (CrispEmbed)
```python
from crispembed import CrispEmbed
model = CrispEmbed("pixie-rune-v1-q8_0.gguf")
vectors = model.encode(["Hello world", "Goodbye world"])
```

## Model Details

| Property | Value |
|----------|-------|
| Architecture | XLM-R |
| Parameters | 560M |
| Embedding Dimension | 1024 |
| Layers | 24 |
| Pooling | CLS |
| Tokenizer | SentencePiece |
| Language | multilingual |
| Q8_0 vs HuggingFace | cross-lingual OK |
| Q4_K vs HuggingFace | cross-lingual OK |

## Server API

CrispEmbed server supports four API dialects:
- `POST /embed` -- native
- `POST /v1/embeddings` -- OpenAI-compatible
- `POST /api/embed` -- Ollama-compatible
- `POST /api/embeddings` -- Ollama legacy

## Credits

- Original model: [telepix/PIXIE-Rune-v1.0](https://huggingface.co/telepix/PIXIE-Rune-v1.0)
- Inference: [CrispEmbed](https://github.com/CrispStrobe/CrispEmbed) (MIT, ggml-based)