fvdb

FVDB - Тонкий фарфор вокруг Файс

fvdb - это простая минимальная обертка вокруг векторной базы данных FAISS. Он использует индекс L2 с нормализованными векторами.

Он использует пакет faiss-cpu и sentence-transformers для внедрения. Если вам нужна версия GPU Faiss (очень вероятно, нет), вы можете просто вручную установить faiss-gpu и использовать GPUIndexFlatL2 вместо IndexFlatL2 в fvdb/db.hy . Вы по-прежнему можете использовать модель встраивания текста GPU, даже при использовании faiss-cpu .

Если резюме включены ( не по умолчанию, см. Раздел «Конфигурация» ниже), резюме выдержки будет сохранена вместе с выдержкой.

Это хорошо соответствует траге.

Функции

• Поиск сходства со счетом
• Выбор предложений-трансформатора
• Полезное форматирование результатов (JSON, Tabulated ...)
• CLI доступ
• Извлекать резюме

Любой вход, отличный от простого текста (Markdown, Asciidoc, RST, исходный код и т. Д.) Выходит из области . Вы должны один из многих доступных пакетов (неструктурированная, Trafiltura, Dockling и т. Д.), Чтобы преобразовать в открытый текст на отдельном шаге.

Использование

 import hy # fvdb is written in Hy, but you can use it from python too
from fvdb import faiss , ingest , similar , sources , write

# data ingestion
v = faiss ()
ingest ( v , "doc.md" )
ingest ( v , "docs-dir" )
write ( v , "/tmp/test.fvdb" ) # defaults to $XDG_DATA_HOME/fvdb (~/.local/share/fvdb/ on Linux)

# search
results = similar ( v , "some query text" )
results = marginal ( v , "some query text" ) # not yet implemented

# information, management
sources ( v )
    { ...
      'docs-dir/Once More to the Lake.txt' ,
      'docs-dir/Politics and the English Language.txt' ,
      'docs-dir/Reflections on Gandhi.txt' ,
      'docs-dir/Shooting an elephant.txt' ,
      'docs-dir/The death of the moth.txt' ,
      ... }

info ( v )
    {   'records' : 42 ,
        'embeddings' : 42 ,
        'embedding_dimension' : 1024 ,
        'is_trained' : True ,
        'path' : '/tmp/test-vdb' ,
        'sources' : 24 ,
        'embedding_model' : 'Alibaba-NLP/gte-large-en-v1.5' }

nuke ( v )

Они также доступны в командной строке.

$ # defaults to $XDG_DATA_HOME/fvdb (~/.local/share/fvdb/ on Linux)
# data ingestion (saves on exit)
$ fvdb ingest doc.md
    Adding 2 records

$ fvdb ingest docs-dir
    Adding 42 records

$ # search
$ fvdb similar -j " some query text " > results.json   # --json / -j gives json output

$ fvdb similar -r 2 " George Orwell's formative experience as a policeman in colonial Burma "
    # defaults to tabulated output (not all fields will be shown)
       score  source                             added                               page    length
    --------  ---------------------------------- --------------------------------  ------  --------
    0.579925  docs-dir/A hanging.txt             2024-11-05T11:37:26.232773+00:00       0      2582
    0.526988  docs-dir/Shooting an elephant.txt  2024-11-05T11:37:43.891659+00:00       0      3889

$ fvdb marginal " some query text "                       # not yet implemented

$ # information, management
$ fvdb sources
    ...
    docs-dir/Once More to the Lake.txt
    docs-dir/Politics and the English Language.txt
    docs-dir/Reflections on Gandhi.txt
    docs-dir/Shooting an elephant.txt
    docs-dir/The death of the moth.txt
    ...

$ fvdb info
    -------------------  -----------------------------
    records              44
    embeddings           44
    embedding_dimension  1024
    is_trained           True
    path                 /tmp/test
    sources              24
    embedding_model      Alibaba-NLP/gte-large-en-v1.5
    -------------------  -----------------------------

$ fvdb nuke

Конфигурация

Ищу $XDG_CONFIG_HOME/fvdb/conf.toml , в противном случае использует по умолчанию.

Вы не можете смешивать модели встраивания в одном FVDB.

Вот пример.

 # Sets the default path to something other than $XDG_CONFIG_HOME/fvdb/conf.toml
path = " /tmp/test.fvdb "

# Summaries are useful if you use an embedding model with large maximum sequence length,
# for example, gte-large-en-v1.5 has maximum sequence length of 8192.
summary = true		

# A conservative default model, maximum sequence length of 512,
# so no point using summaries.
embeddings.model = " all-mpnet-base-v2 "

# # Some models need extra options
# embeddings.model = "Alibaba-NLP/gte-large-en-v1.5"
# embeddings.trust_remote_code = true
# # You can put some smaller models on a cpu, but larger models will be slow
# embeddings.device = "cpu" 

Установка

Сначала установите Pytorch, который используется sentence-transformers . Вы должны решить, хотите ли вы версию CPU или CUDA (NVIDIA GPU) Pytorch. Для только текстовых внедрений для fvdb достаточно процессор, с моделью по умолчанию.

Затем,

pip install fvdb

И это все.

Запланировано

• Дополнительные бары прогресса для долгой работы