@urna/cli 0.5.0 → 0.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.gitignore +2 -0
- package/README.md +9 -9
- package/npm-shrinkwrap.json +2 -2
- package/package.json +2 -2
- package/run-urna.js +0 -0
package/.gitignore
ADDED
package/README.md
CHANGED
|
@@ -13,7 +13,7 @@ brew install hoffresearch/urna/urna
|
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
```sh
|
|
16
|
-
npm install -g urna
|
|
16
|
+
npm install -g @urna/cli
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
```sh
|
|
@@ -36,7 +36,7 @@ Python only, no setup step needed:
|
|
|
36
36
|
pip install "urna[embed]"
|
|
37
37
|
```
|
|
38
38
|
|
|
39
|
-
Windows, docker, `cargo binstall` and how to verify a download are in the [install reference](https://github.com/hoffresearch/urna/blob/main/docs/
|
|
39
|
+
Windows, docker, `cargo binstall` and how to verify a download are in the [install reference](https://github.com/hoffresearch/urna/blob/main/docs/USAGE.md#reference).
|
|
40
40
|
|
|
41
41
|
## In the terminal
|
|
42
42
|
|
|
@@ -76,7 +76,7 @@ urna cite examples/quickstart/out/quickstart.urna 'urna://sha256:1147b256.../sha
|
|
|
76
76
|
urna validate examples/quickstart/out/quickstart.urna
|
|
77
77
|
```
|
|
78
78
|
|
|
79
|
-
`ask` prints the answer with its citation, `retrieve` prints json for another program, `cite` turns a citation back into the stored text, and `validate` checks every hash. To build from your own rows, see [usage section 13](https://github.com/hoffresearch/urna/blob/main/docs/
|
|
79
|
+
`ask` prints the answer with its citation, `retrieve` prints json for another program, `cite` turns a citation back into the stored text, and `validate` checks every hash. To build from your own rows, see [usage section 13](https://github.com/hoffresearch/urna/blob/main/docs/USAGE.md).
|
|
80
80
|
|
|
81
81
|
## What the file guarantees
|
|
82
82
|
|
|
@@ -153,7 +153,7 @@ urna retrieve my_corpus.urna "can I use this offline" -k 5 --format jsonl
|
|
|
153
153
|
urna build --spec corpus.toml --dry-run
|
|
154
154
|
```
|
|
155
155
|
|
|
156
|
-
`build` reads one toml: the source (sqlite, csv, jsonl, an image dir), the media settings, and one or more embedding models from the registry (`potion`, `clip-vit-b32`, `siglip2`, `wemm-2b`, ...). Each model becomes a named vector space in the same file. The full spec is in [usage section 13](https://github.com/hoffresearch/urna/blob/main/docs/
|
|
156
|
+
`build` reads one toml: the source (sqlite, csv, jsonl, an image dir), the media settings, and one or more embedding models from the registry (`potion`, `clip-vit-b32`, `siglip2`, `wemm-2b`, ...). Each model becomes a named vector space in the same file. The full spec is in [usage section 13](https://github.com/hoffresearch/urna/blob/main/docs/USAGE.md).
|
|
157
157
|
|
|
158
158
|
</details>
|
|
159
159
|
|
|
@@ -228,7 +228,7 @@ urna doctor
|
|
|
228
228
|
| lancedb | 16.7 | 19.4 | 612 |
|
|
229
229
|
| sqlite-vec | 19.8 | 24.8 | 50 |
|
|
230
230
|
|
|
231
|
-
Both urna rows return recall@10 = 1.000. Urna's cold open includes checking every section hash before the first answer. Urna does not do updates, filters or concurrent writers. Method and the full table: [docs/
|
|
231
|
+
Both urna rows return recall@10 = 1.000. Urna's cold open includes checking every section hash before the first answer. Urna does not do updates, filters or concurrent writers. Method and the full table: [docs/BENCH.md](https://github.com/hoffresearch/urna/blob/main/docs/BENCH.md).
|
|
232
232
|
|
|
233
233
|
<details>
|
|
234
234
|
<summary>Presets: size vs recall</summary>
|
|
@@ -242,7 +242,7 @@ Both urna rows return recall@10 = 1.000. Urna's cold open includes checking ever
|
|
|
242
242
|
| `nano` | int4 | hnsw | 0.209 | 0.913 |
|
|
243
243
|
| `hybrid` | float32 | hnsw + bm25 | 0.609 | 1.000 |
|
|
244
244
|
|
|
245
|
-
Measured on a 30,725-chunk pt-br corpus. Recall here is rank stability under quantization, not real-query quality. Details in [usage section 6](https://github.com/hoffresearch/urna/blob/main/docs/
|
|
245
|
+
Measured on a 30,725-chunk pt-br corpus. Recall here is rank stability under quantization, not real-query quality. Details in [usage section 6](https://github.com/hoffresearch/urna/blob/main/docs/USAGE.md).
|
|
246
246
|
|
|
247
247
|
</details>
|
|
248
248
|
|
|
@@ -261,11 +261,11 @@ Text-to-image hit@1 over every card: siglip2 0.750, wemm-2b 0.744, jina 0.336, c
|
|
|
261
261
|
|
|
262
262
|
## Reference
|
|
263
263
|
|
|
264
|
-
- [docs/
|
|
265
|
-
- [docs/
|
|
264
|
+
- [docs/USAGE.md](https://github.com/hoffresearch/urna/blob/main/docs/USAGE.md): every verb, presets, models, builds, install channels
|
|
265
|
+
- [docs/BENCH.md](https://github.com/hoffresearch/urna/blob/main/docs/BENCH.md): how the numbers were measured
|
|
266
266
|
- [docs/SECURITY.md](https://github.com/hoffresearch/urna/blob/main/docs/SECURITY.md): reporting, hardening, data governance
|
|
267
267
|
- [docs/CHANGELOG](https://github.com/hoffresearch/urna/blob/main/docs/CHANGELOG): releases with measured numbers
|
|
268
|
-
- [docs/arc/
|
|
268
|
+
- [docs/arc/ARC.toml](https://github.com/hoffresearch/urna/blob/main/docs/arc/ARC.toml): the architecture map
|
|
269
269
|
- [AGENTS.md](https://github.com/hoffresearch/urna/blob/main/.contracts/.agents/AGENTS.md): notes for contributors and agents
|
|
270
270
|
|
|
271
271
|
The crates are `urna-format` (the container), `urna-runtime` (search), `urna` (the binary) and `urna-python` (the bridge).
|
package/npm-shrinkwrap.json
CHANGED
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
"hasInstallScript": true,
|
|
20
20
|
"license": "MIT",
|
|
21
21
|
"name": "@urna/cli",
|
|
22
|
-
"version": "0.5.
|
|
22
|
+
"version": "0.5.1"
|
|
23
23
|
},
|
|
24
24
|
"node_modules/detect-libc": {
|
|
25
25
|
"engines": {
|
|
@@ -48,5 +48,5 @@
|
|
|
48
48
|
}
|
|
49
49
|
},
|
|
50
50
|
"requires": true,
|
|
51
|
-
"version": "0.5.
|
|
51
|
+
"version": "0.5.1"
|
|
52
52
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"artifactDownloadUrls": [
|
|
3
|
-
"https://github.com/hoffresearch/urna/releases/download/v0.5.
|
|
3
|
+
"https://github.com/hoffresearch/urna/releases/download/v0.5.1"
|
|
4
4
|
],
|
|
5
5
|
"bin": {
|
|
6
6
|
"urna": "run-urna.js"
|
|
@@ -118,7 +118,7 @@
|
|
|
118
118
|
"zipExt": ".tar.xz"
|
|
119
119
|
}
|
|
120
120
|
},
|
|
121
|
-
"version": "0.5.
|
|
121
|
+
"version": "0.5.1",
|
|
122
122
|
"volta": {
|
|
123
123
|
"node": "18.14.1",
|
|
124
124
|
"npm": "9.5.0"
|
package/run-urna.js
CHANGED
|
File without changes
|