async annoy

async-annoy readme

概要

async-annoy Webサーバーのような非同期アプリケーションでAshy Indicesを使用して単純化します。同時アクセスの複雑さを心配することなく、インデックスから読んだり書いたりするように構築されています。最近の隣人を照会したり、インデックスを構築したりするかどうかにかかわらず、すべてがバックグラウンドで簡単にセーフ操作を取得します。

特徴

• 自動化されたインデックス管理：ディスク上のイライラインデックスの管理のすべてのトリッキーな部分を処理します。
• シンプルになりました：舞台裏のアクセスロックを管理することにより、複数の読者または単一のライターを一度にサポートします。

インストール

pip install async-annoy

ライブラリを実行するために必要であるため、イライラとnumpyがインストールされていることを確認してください。

使い方

インデックスから読む

Webリクエストに応じて最近隣人を取得するのに最適です。

 from async_annoy import AsyncAnnoy

async with AsyncAnnoy ( "my_index" ). reader () as reader :
    neighbours = await reader . get_neighbours_for ( vector = my_vector , n = 5 )
    print ( neighbours )

インデックスへの書き込み

作家は、すべての読者が終了し、ゼロからインデックスを開始するのを待ちます。イライラライブラリはインデックスの更新をサポートせず、再構築のみをサポートしています。

 from async_annoy import AsyncAnnoy

async with AsyncAnnoy ( "my_index" ). writer () as writer :
    await writer . add_item ( index = 1 , vector = my_vector )
    # The index is automatically built and saved when done. 

構成

async-annoyの最初のセットアップは、環境変数に依存して、イライラインデックスパラメーターを構成し、シームレスなスタートを保証します。これらのデフォルトは利便性を提供しますが、アプリケーションの特定の要件に合わせて設定をカスタマイズする必要がある場合があります。同じインデックスと対話するすべての読者と作家の間でパラメーターの一貫性を維持することが重要です。

デフォルトのパラメーター

async-annoy初期構成に次の環境変数を使用します。

• ASYNC_ANNOY_DIMENSIONS ：インデックスに保存されているベクトルの次元。
• ASYNC_ANNOY_METRIC ：インデックス内のベクトルを比較するために使用される距離メトリック（例：「Angular」、「Euclidean」）。

デフォルトのパラメーターをオーバーライドします

async-annoy環境変数を使用して自分自身を構成しますが、これらのデフォルトをコードで直接オーバーライドできます。新しいAnnoyReaderまたはAnnoyWriterを作成するときは、希望する寸法とメトリックを引数として渡すだけです。

 from async_annoy import AsyncAnnoy

# Override default parameters when initializing
index_manager = AsyncAnnoy ( "my_index" , dimensions = 128 , metric = "euclidean" )

開発状況

現在、Async-Annoyはアルファにあります。テストの準備ができており、フィードバックを改善するためのフィードバックに熱心です。これは初期バージョンであるため、機能を追加し、エクスペリエンスをスムーズにすることに取り組んでいます。