Update BM25S model

.gitattributes

@@ -33,3 +33,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+corpus.jsonl filter=lfs diff=lfs merge=lfs -text
+vocab.index.json filter=lfs diff=lfs merge=lfs -text

README.md

@@ -0,0 +1,157 @@
+---
+language: en
+library_name: bm25s
+tags:
+- bm25
+- bm25s
+- retrieval
+- search
+- lexical
+---
+
+# BM25S Index
+
+This is a BM25S index created with the [`bm25s` library](https://github.com/xhluca/bm25s) (version `0.2.3`), an ultra-fast implementation of BM25. It can be used for lexical retrieval tasks.
+
+BM25S Related Links:
+
+* 🏠[Homepage](https://bm25s.github.io)
+* 💻[GitHub Repository](https://github.com/xhluca/bm25s)
+* 🤗[Blog Post](https://huggingface.co/blog/xhluca/bm25s)
+* 📝[Technical Report](https://arxiv.org/abs/2407.03618)
+
+
+## Installation
+
+You can install the `bm25s` library with `pip`:
+
+```bash
+pip install "bm25s==0.2.3"
+
+# Include extra dependencies like stemmer
+pip install "bm25s[full]==0.2.3"
+
+# For huggingface hub usage
+pip install huggingface_hub
+```
+
+## Loading a `bm25s` index
+
+You can use this index for information retrieval tasks. Here is an example:
+
+```python
+import bm25s
+from bm25s.hf import BM25HF
+
+# Load the index
+retriever = BM25HF.load_from_hub("tien314/hscode8")
+
+# You can retrieve now
+query = "a cat is a feline"
+results = retriever.retrieve(bm25s.tokenize(query), k=3)
+```
+
+## Saving a `bm25s` index
+
+You can save a `bm25s` index to the Hugging Face Hub. Here is an example:
+
+```python
+import bm25s
+from bm25s.hf import BM25HF
+
+corpus = [
+    "a cat is a feline and likes to purr",
+    "a dog is the human's best friend and loves to play",
+    "a bird is a beautiful animal that can fly",
+    "a fish is a creature that lives in water and swims",
+]
+
+retriever = BM25HF(corpus=corpus)
+retriever.index(bm25s.tokenize(corpus))
+
+token = None  # You can get a token from the Hugging Face website
+retriever.save_to_hub("tien314/hscode8", token=token)
+```
+
+## Advanced usage
+
+You can leverage more advanced features of the BM25S library during `load_from_hub`:
+
+```python
+# Load corpus and index in memory-map (mmap=True) to reduce memory
+retriever = BM25HF.load_from_hub("tien314/hscode8", load_corpus=True, mmap=True)
+
+# Load a different branch/revision
+retriever = BM25HF.load_from_hub("tien314/hscode8", revision="main")
+
+# Change directory where the local files should be downloaded
+retriever = BM25HF.load_from_hub("tien314/hscode8", local_dir="/path/to/dir")
+
+# Load private repositories with a token:
+retriever = BM25HF.load_from_hub("tien314/hscode8", token=token)
+```
+
+## Tokenizer
+
+If you have saved a `Tokenizer` object with the index using the following approach:
+
+```python
+from bm25s.hf import TokenizerHF
+
+token = "your_hugging_face_token"
+tokenizer = TokenizerHF(corpus=corpus, stopwords="english")
+tokenizer.save_to_hub("tien314/hscode8", token=token)
+
+# and stopwords too
+tokenizer.save_stopwords_to_hub("tien314/hscode8", token=token)
+```
+
+Then, you can load the tokenizer using the following code:
+
+```python
+from bm25s.hf import TokenizerHF
+
+tokenizer = TokenizerHF(corpus=corpus, stopwords=[])
+tokenizer.load_vocab_from_hub("tien314/hscode8", token=token)
+tokenizer.load_stopwords_from_hub("tien314/hscode8", token=token)
+```
+
+
+## Stats
+
+This dataset was created using the following data:
+
+| Statistic | Value |
+| --- | --- |
+| Number of documents | 791616 |
+| Number of tokens | 8818694 |
+| Average tokens per document | 11.14 |
+
+## Parameters
+
+The index was created with the following parameters:
+
+| Parameter | Value |
+| --- | --- |
+| k1 | `1.5` |
+| b | `0.75` |
+| delta | `0.5` |
+| method | `lucene` |
+| idf method | `lucene` |
+
+## Citation
+
+To cite `bm25s`, please use the following bibtex:
+
+```
+@misc{lu_2024_bm25s,
+      title={BM25S: Orders of magnitude faster lexical search via eager sparse scoring}, 
+      author={Xing Han Lù},
+      year={2024},
+      eprint={2407.03618},
+      archivePrefix={arXiv},
+      primaryClass={cs.IR},
+      url={https://arxiv.org/abs/2407.03618}, 
+}
+```
+

corpus.jsonl

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:26b3f17468ce27a2a2624bd67aceaaaf9d1363f10cd8482f0aa1e71b414a4e83
+size 87071998

data.csc.index.npy

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f124c4c4d9beb8eedc20bf8ea6f452c2ce8472aeab724a46970182e3ffbea3d9
+size 35274904

indices.csc.index.npy

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9e7e82d8f583b6dc5948c9c9faf2898bd9467db795477481ec1e2bc1bc4d1499
+size 35274904

indptr.csc.index.npy

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:80cd1256b07bb59e9b8c2e5dbb706fff27da0daf336b77e4af3c6c4b38a8d6b6
+size 2249916

params.index.json

@@ -0,0 +1,12 @@
+{
+    "k1": 1.5,
+    "b": 0.75,
+    "delta": 0.5,
+    "method": "lucene",
+    "idf_method": "lucene",
+    "dtype": "float32",
+    "int_dtype": "int32",
+    "num_docs": 791616,
+    "version": "0.2.3",
+    "backend": "numpy"
+}

vocab.index.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:baa46f4faa9fbd28089112f6903af07248635544d37bf4240ecdcd39b2bf684b
+size 11550214