vexor 0.21.1__tar.gz → 0.23.0rc1__tar.gz

{vexor-0.21.1 → vexor-0.23.0rc1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vexor
-Version: 0.21.1
+Version: 0.23.0rc1
 Summary: A vector-powered CLI for semantic search over files.
 Project-URL: Repository, https://github.com/scarletkc/vexor
 Author: scarletkc
@@ -22,7 +22,7 @@ Classifier: Topic :: Text Processing :: Indexing
 Classifier: Topic :: Utilities
 Requires-Python: >=3.9
 Requires-Dist: charset-normalizer>=3.3.0
-Requires-Dist: google-genai>=0.5.0
+Requires-Dist: google-genai>=1.57.0
 Requires-Dist: numpy>=1.23.0
 Requires-Dist: openai>=1.0.0
 Requires-Dist: pathspec>=0.12.1
@@ -64,6 +64,7 @@ Description-Content-Type: text/markdown
 [![CI](https://img.shields.io/github/actions/workflow/status/scarletkc/vexor/publish.yml?branch=main)](https://github.com/scarletkc/vexor/actions/workflows/publish.yml)
 [![Codecov](https://img.shields.io/codecov/c/github/scarletkc/vexor/main)](https://codecov.io/github/scarletkc/vexor)
 [![License](https://img.shields.io/github/license/scarletkc/vexor.svg)](https://github.com/scarletkc/vexor/blob/main/LICENSE)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/scarletkc/vexor)
 
 </div>
 
@@ -76,6 +77,13 @@ It supports configurable embedding and reranking providers, and exposes the same
       Vexor Demo Video
     </video>
 
+## Featured In
+
+Vexor has been recognized and featured by the community:
+
+- **[Ruan Yifeng's Weekly (Issue #379)](https://github.com/ruanyf/weekly/blob/master/docs/issue-379.md#ai-%E7%9B%B8%E5%85%B3)** - A leading tech newsletter in the Chinese developer community.
+- **[Awesome Claude Skills](https://github.com/VoltAgent/awesome-claude-skills?tab=readme-ov-file#development-and-testing)** - Curated list of best-in-class skills for AI agents.
+
 ## Why Vexor?
 
 When you remember what a file *does* but forget its name or location, Vexor finds it instantly—no grep patterns or directory traversal needed.
@@ -164,12 +172,15 @@ Skill source: [`plugins/vexor/skills/vexor-cli`](https://github.com/scarletkc/ve
 ## Configuration
 
 ```bash
-vexor config --set-provider openai          # default; also supports gemini/custom/local
+vexor config --set-provider openai          # default; also supports gemini/voyageai/custom/local
 vexor config --set-model text-embedding-3-small
+vexor config --set-provider voyageai        # uses voyage defaults when model/base_url are unset
 vexor config --set-batch-size 0             # 0 = single request
 vexor config --set-embed-concurrency 4       # parallel embedding requests
 vexor config --set-extract-concurrency 4     # parallel file extraction workers
 vexor config --set-extract-backend auto      # auto|thread|process (default: auto)
+vexor config --set-embedding-dimensions 1024 # optional, model/provider dependent
+vexor config --clear-embedding-dimensions    # reset to model default dimension
 vexor config --set-auto-index true          # auto-index before search (default)
 vexor config --rerank bm25                  # optional BM25 rerank for top-k results
 vexor config --rerank flashrank             # FlashRank rerank (requires optional extra)
@@ -195,7 +206,7 @@ Config stored in `~/.vexor/config.json`.
 ```bash
 vexor config --set-api-key "YOUR_KEY"
 ```
-Or via environment: `VEXOR_API_KEY`, `OPENAI_API_KEY`, or `GOOGLE_GENAI_API_KEY`.
+Or via environment: `VEXOR_API_KEY`, `OPENAI_API_KEY`, `GOOGLE_GENAI_API_KEY`, or `VOYAGE_API_KEY`.
 
 ### Rerank
 
@@ -215,11 +226,30 @@ Recommended defaults:
 
 ### Providers: Remote vs Local
 
-Vexor supports both remote API providers (`openai`, `gemini`, `custom`) and a local provider (`local`):
+Vexor supports both remote API providers (`openai`, `gemini`, `voyageai`, `custom`) and a local provider (`local`):
 - Remote providers use `api_key` and optional `base_url`.
+- `voyageai` defaults to `https://api.voyageai.com/v1` when `base_url` is not set.
 - `custom` is OpenAI-compatible and requires both `model` and `base_url`.
 - Local provider ignores `api_key/base_url` and only uses `model` plus `local_cuda` (CPU/GPU switch).
 
+### Embedding Dimensions
+
+Embedding dimensions are optional. If unset, the provider/model default is used.
+Custom dimensions are validated for:
+- OpenAI `text-embedding-3-*`
+- Voyage `voyage-3*` and `voyage-code-3*`
+
+```bash
+vexor config --set-embedding-dimensions 1024
+vexor config --clear-embedding-dimensions
+```
+
+If you change dimensions after an index is built, rebuild the index:
+
+```bash
+vexor index --path .
+```
+
 ### Local Model (Offline)
 
 Install the lightweight local backend:
@@ -315,8 +345,14 @@ Porcelain output fields: `rank`, `similarity`, `path`, `chunk_index`, `start_lin
 
 See [docs](https://github.com/scarletkc/vexor/tree/main/docs) for more details.
 
+## Contributing
+
 Contributions, issues, and PRs welcome! Star if you find it helpful.
 
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=scarletkc/vexor&type=date&legend=top-left)](https://www.star-history.com/#scarletkc/vexor&type=date&legend=top-left)
+
 ## License
 
 [MIT](http://github.com/scarletkc/vexor/blob/main/LICENSE)

{vexor-0.21.1 → vexor-0.23.0rc1}/README.md

@@ -9,6 +9,7 @@
 [![CI](https://img.shields.io/github/actions/workflow/status/scarletkc/vexor/publish.yml?branch=main)](https://github.com/scarletkc/vexor/actions/workflows/publish.yml)
 [![Codecov](https://img.shields.io/codecov/c/github/scarletkc/vexor/main)](https://codecov.io/github/scarletkc/vexor)
 [![License](https://img.shields.io/github/license/scarletkc/vexor.svg)](https://github.com/scarletkc/vexor/blob/main/LICENSE)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/scarletkc/vexor)
 
 </div>
 
@@ -21,6 +22,13 @@ It supports configurable embedding and reranking providers, and exposes the same
       Vexor Demo Video
     </video>
 
+## Featured In
+
+Vexor has been recognized and featured by the community:
+
+- **[Ruan Yifeng's Weekly (Issue #379)](https://github.com/ruanyf/weekly/blob/master/docs/issue-379.md#ai-%E7%9B%B8%E5%85%B3)** - A leading tech newsletter in the Chinese developer community.
+- **[Awesome Claude Skills](https://github.com/VoltAgent/awesome-claude-skills?tab=readme-ov-file#development-and-testing)** - Curated list of best-in-class skills for AI agents.
+
 ## Why Vexor?
 
 When you remember what a file *does* but forget its name or location, Vexor finds it instantly—no grep patterns or directory traversal needed.
@@ -109,12 +117,15 @@ Skill source: [`plugins/vexor/skills/vexor-cli`](https://github.com/scarletkc/ve
 ## Configuration
 
 ```bash
-vexor config --set-provider openai          # default; also supports gemini/custom/local
+vexor config --set-provider openai          # default; also supports gemini/voyageai/custom/local
 vexor config --set-model text-embedding-3-small
+vexor config --set-provider voyageai        # uses voyage defaults when model/base_url are unset
 vexor config --set-batch-size 0             # 0 = single request
 vexor config --set-embed-concurrency 4       # parallel embedding requests
 vexor config --set-extract-concurrency 4     # parallel file extraction workers
 vexor config --set-extract-backend auto      # auto|thread|process (default: auto)
+vexor config --set-embedding-dimensions 1024 # optional, model/provider dependent
+vexor config --clear-embedding-dimensions    # reset to model default dimension
 vexor config --set-auto-index true          # auto-index before search (default)
 vexor config --rerank bm25                  # optional BM25 rerank for top-k results
 vexor config --rerank flashrank             # FlashRank rerank (requires optional extra)
@@ -140,7 +151,7 @@ Config stored in `~/.vexor/config.json`.
 ```bash
 vexor config --set-api-key "YOUR_KEY"
 ```
-Or via environment: `VEXOR_API_KEY`, `OPENAI_API_KEY`, or `GOOGLE_GENAI_API_KEY`.
+Or via environment: `VEXOR_API_KEY`, `OPENAI_API_KEY`, `GOOGLE_GENAI_API_KEY`, or `VOYAGE_API_KEY`.
 
 ### Rerank
 
@@ -160,11 +171,30 @@ Recommended defaults:
 
 ### Providers: Remote vs Local
 
-Vexor supports both remote API providers (`openai`, `gemini`, `custom`) and a local provider (`local`):
+Vexor supports both remote API providers (`openai`, `gemini`, `voyageai`, `custom`) and a local provider (`local`):
 - Remote providers use `api_key` and optional `base_url`.
+- `voyageai` defaults to `https://api.voyageai.com/v1` when `base_url` is not set.
 - `custom` is OpenAI-compatible and requires both `model` and `base_url`.
 - Local provider ignores `api_key/base_url` and only uses `model` plus `local_cuda` (CPU/GPU switch).
 
+### Embedding Dimensions
+
+Embedding dimensions are optional. If unset, the provider/model default is used.
+Custom dimensions are validated for:
+- OpenAI `text-embedding-3-*`
+- Voyage `voyage-3*` and `voyage-code-3*`
+
+```bash
+vexor config --set-embedding-dimensions 1024
+vexor config --clear-embedding-dimensions
+```
+
+If you change dimensions after an index is built, rebuild the index:
+
+```bash
+vexor index --path .
+```
+
 ### Local Model (Offline)
 
 Install the lightweight local backend:
@@ -260,8 +290,14 @@ Porcelain output fields: `rank`, `similarity`, `path`, `chunk_index`, `start_lin
 
 See [docs](https://github.com/scarletkc/vexor/tree/main/docs) for more details.
 
+## Contributing
+
 Contributions, issues, and PRs welcome! Star if you find it helpful.
 
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=scarletkc/vexor&type=date&legend=top-left)](https://www.star-history.com/#scarletkc/vexor&type=date&legend=top-left)
+
 ## License
 
 [MIT](http://github.com/scarletkc/vexor/blob/main/LICENSE)

{vexor-0.21.1 → vexor-0.23.0rc1}/plugins/vexor/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "vexor",
-  "version": "0.21.1",
+  "version": "0.23.0rc1",
   "description": "A vector-powered CLI for semantic search over files (Vexor skill bundle).",
   "author": {
     "name": "scarletkc"

{vexor-0.21.1 → vexor-0.23.0rc1}/pyproject.toml

@@ -27,7 +27,7 @@ classifiers = [
     "Topic :: Scientific/Engineering :: Information Analysis",
 ]
 dependencies = [
-    "google-genai>=0.5.0",
+    "google-genai>=1.57.0",
     "openai>=1.0.0",
     "python-dotenv>=1.0.0",
     "pathspec>=0.12.1",

{vexor-0.21.1 → vexor-0.23.0rc1}/vexor/__init__.py

@@ -2,20 +2,35 @@
 
 from __future__ import annotations
 
-from .api import VexorError, clear_index, index, search, set_config_json, set_data_dir
+from .api import (
+    InMemoryIndex,
+    VexorClient,
+    VexorError,
+    clear_index,
+    config_context,
+    index,
+    index_in_memory,
+    search,
+    set_config_json,
+    set_data_dir,
+)
 
 __all__ = [
     "__version__",
+    "InMemoryIndex",
+    "VexorClient",
     "VexorError",
     "clear_index",
+    "config_context",
     "get_version",
     "index",
+    "index_in_memory",
     "search",
     "set_config_json",
     "set_data_dir",
 ]
 
-__version__ = "0.21.1"
+__version__ = "0.23.0rc1"
 
 
 def get_version() -> str: