Publish as vlora-dev on PyPI (v0.2.1)

Rename package from vlora to vlora-dev — the vlora name is taken on PyPI
by an unrelated project. Import stays `import vlora`. Added packaging
as explicit dependency (safetensors 0.7.0 needs it).

Updated all install commands across README, docs, examples, website,
and error messages.

Author: tveseli

README.md

@@ -11,7 +11,7 @@ Based on the [Share paper](https://arxiv.org/abs/2602.06043): LoRA adapters acro
 ## Install
 
 ```bash
-pip install vlora
+pip install vlora-dev
 ```
 
 Or from source:
@@ -321,7 +321,7 @@ Tested with 8 [Lots-of-LoRAs](https://huggingface.co/Lots-of-LoRAs) adapters (Mi
 
 Run the benchmark yourself:
 ```bash
-pip install vlora[hub]
+pip install vlora-dev[hub]
 python examples/real_adapters.py
 ```
 
@@ -355,8 +355,8 @@ subspace.save("updated_subspace/")
 - `torch >= 2.0`
 - `safetensors >= 0.4`
 - `click >= 8.0`
-- `huggingface-hub >= 0.20` *(optional, `pip install vlora[hub]`)*
-- `transformers >= 4.38` *(optional, `pip install vlora[hf]`)*
+- `huggingface-hub >= 0.20` *(optional, `pip install vlora-dev[hub]`)*
+- `transformers >= 4.38` *(optional, `pip install vlora-dev[hf]`)*
 
 ## Citation
 

docs/index.md

@@ -7,7 +7,7 @@ Based on the [Share paper](https://arxiv.org/abs/2602.06043): LoRA adapters acro
 ## Install
 
 ```bash
-pip install vlora
+pip install vlora-dev
 ```
 
 ## Quick Example

docs/launch_post.md

@@ -29,7 +29,7 @@ At k=4 components, B-side matrices explain 95% of variance across 8 Mistral-7B a
 ### What's in the box
 
 ```bash
-pip install vlora
+pip install vlora-dev
 ```
 
 **CLI** (9 commands):
@@ -60,7 +60,7 @@ vlora validate subspace/
 ### Links
 
 - GitHub: https://github.com/tveseli/vlora
-- PyPI: https://pypi.org/project/vlora/
+- PyPI: https://pypi.org/project/vlora-dev/
 - Paper: https://arxiv.org/abs/2602.06043
 - Website: https://vlora-dev.web.app
 

docs/quickstart.md

@@ -7,17 +7,17 @@ Try vlora in Google Colab or locally.
 ## Install
 
 ```bash
-pip install vlora
+pip install vlora-dev
 ```
 
 For HuggingFace Hub loading:
 ```bash
-pip install vlora[hub]
+pip install vlora-dev[hub]
 ```
 
 For HuggingFace Trainer integration:
 ```bash
-pip install vlora[hf]
+pip install vlora-dev[hf]
 ```
 
 ## CLI Workflow

examples/hf_trainer_subspace.py

@@ -4,7 +4,7 @@
 (a few hundred parameters) instead of full LoRA matrices (hundreds of thousands).
 
 Usage:
-    pip install vlora[hf]
+    pip install vlora-dev[hf]
     python examples/hf_trainer_subspace.py
 """
 

examples/real_adapters.py

@@ -6,7 +6,7 @@
 memory savings.
 
 Usage:
-    pip install vlora[hub]
+    pip install vlora-dev[hub]
     python examples/real_adapters.py
 """
 

pyproject.toml

@@ -3,8 +3,8 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [project]
-name = "vlora"
-version = "0.2.0"
+name = "vlora-dev"
+version = "0.2.1"
 description = "Shared low-rank subspaces for efficient LoRA adapter management"
 readme = "README.md"
 license = "Apache-2.0"
@@ -21,6 +21,7 @@ classifiers = [
 dependencies = [
     "torch>=2.0",
     "safetensors>=0.4",
+    "packaging>=21.0",
     "numpy>=1.21",
     "click>=8.0",
 ]

src/vlora/integrations/huggingface.py

@@ -44,7 +44,7 @@ def _require_transformers():
     if not HAS_TRANSFORMERS:
         raise ImportError(
             "transformers is required for HuggingFace integration. "
-            "Install with: pip install vlora[hf]"
+            "Install with: pip install vlora-dev[hf]"
         )
 
 

src/vlora/io.py

@@ -114,14 +114,14 @@ def load_adapter(path: str | Path) -> LoRAWeights:
 def load_adapter_from_hub(repo_id: str, revision: str | None = None) -> LoRAWeights:
     """Load a PEFT LoRA adapter from HuggingFace Hub.
 
-    Requires the `huggingface-hub` package (install with `pip install vlora[hub]`).
+    Requires the `huggingface-hub` package (install with `pip install vlora-dev[hub]`).
     """
     try:
         from huggingface_hub import snapshot_download
     except ImportError:
         raise ImportError(
             "huggingface-hub is required to load from Hub. "
-            "Install with: pip install vlora[hub]"
+            "Install with: pip install vlora-dev[hub]"
         )
 
     local_dir = snapshot_download(