Science Score: 54.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
✓Academic publication links
Links to: arxiv.org -
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (9.4%) to scientific vocabulary
Repository
Your filesystem as a vector database
Basic Info
- Host: GitHub
- Owner: perone
- License: apache-2.0
- Language: Python
- Default Branch: main
- Homepage: https://vectorvfs.readthedocs.io
- Size: 672 KB
Statistics
- Stars: 398
- Watchers: 5
- Forks: 13
- Open Issues: 6
- Releases: 0
Metadata Files
README.md
VectorVFS: Your Filesystem as a Vector Database
Documentation is at https://vectorvfs.readthedocs.io.
VectorVFS is a lightweight Python package that transforms your Linux filesystem into a vector database by leveraging the native VFS (Virtual File System) extended attributes. Rather than maintaining a separate index or external database, VectorVFS stores vector embeddings directly alongside each file—turning your existing directory structure into an efficient and semantically searchable embedding store.
VectorVFS currently uses Meta's Perception Encoders (PE) [arxiv] which includes image/video encoders for vision language understanding, it outperforms InternVL3, Qwen2.5VL and SigLIP2 for zero-shot image tasks. More models support coming soon.
Key Features
Zero-overhead indexing
Embeddings are stored as extended attributes (xattrs) on each file, eliminating the need for external index files or services.Seamless retrieval
Perform searches across your filesystem, retrieving files by embedding similarity.Flexible embedding support
Plug in any embedding model—from pre-trained transformers to custom feature extractors—and let VectorVFS handle storage and lookup.Lightweight and portable
Built on native Linux VFS functionality, VectorVFS requires no additional daemons, background processes, or databases.
Owner
- Name: Christian S. Perone
- Login: perone
- Kind: user
- Location: London, United Kingdom
- Website: http://blog.christianperone.com/
- Twitter: tarantulae
- Repositories: 43
- Profile: https://github.com/perone
Machine Learning / Research
Citation (CITATION.cff)
cff-version: "1.2.0"
date-released: 2025-05
message: "If you use this software, please cite it using these metadata."
title: "vectorvfs: Your filesystem is a vector database"
url: "https://github.com/perone/vectorvfs"
authors:
- family-names: Perone
given-names: Christian
GitHub Events
Total
- Issues event: 2
- Watch event: 375
- Issue comment event: 4
- Public event: 1
- Push event: 6
- Pull request review event: 2
- Pull request review comment event: 2
- Pull request event: 4
- Fork event: 9
Last Year
- Issues event: 2
- Watch event: 375
- Issue comment event: 4
- Public event: 1
- Push event: 6
- Pull request review event: 2
- Pull request review comment event: 2
- Pull request event: 4
- Fork event: 9
Committers
Last synced: 10 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Christian S. Perone | c****e@g****m | 24 |
Issues and Pull Requests
Last synced: 8 months ago
All Time
- Total issues: 6
- Total pull requests: 1
- Average time to close issues: N/A
- Average time to close pull requests: 1 day
- Total issue authors: 6
- Total pull request authors: 1
- Average comments per issue: 1.0
- Average comments per pull request: 2.0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 6
- Pull requests: 1
- Average time to close issues: N/A
- Average time to close pull requests: 1 day
- Issue authors: 6
- Pull request authors: 1
- Average comments per issue: 1.0
- Average comments per pull request: 2.0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- apiszcz (1)
- kzhrv (1)
- sammcj (1)
- qlyoung (1)
- Ayanami1314 (1)
- nikste (1)
Pull Request Authors
- snwagh (2)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 35 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 2
- Total maintainers: 1
pypi.org: vectorvfs
Your filesystem is a vector database.
- Homepage: https://github.com/perone/vectorvfs
- Documentation: https://vectorvfs.readthedocs.io/
- License: apache-2.0
-
Latest release: 0.3.0
published 11 months ago
Rankings
Maintainers (1)
Dependencies
- alabaster ==1.0.0
- anyio ==4.9.0
- asttokens ==3.0.0
- babel ==2.17.0
- certifi ==2025.1.31
- charset-normalizer ==3.4.1
- click ==8.1.8
- colorama ==0.4.6
- decorator ==5.2.1
- docutils ==0.21.2
- executing ==2.2.0
- h11 ==0.16.0
- idna ==3.10
- imagesize ==1.4.1
- iniconfig ==2.1.0
- ipdb ==0.13.13
- ipython ==9.2.0
- ipython-pygments-lexers ==1.1.1
- jedi ==0.19.2
- jinja2 ==3.1.6
- markupsafe ==3.0.2
- matplotlib-inline ==0.1.7
- mypy ==1.15.0
- mypy-extensions ==1.1.0
- packaging ==25.0
- parso ==0.8.4
- pexpect ==4.9.0
- pluggy ==1.5.0
- prompt-toolkit ==3.0.51
- ptyprocess ==0.7.0
- pure-eval ==0.2.3
- pygments ==2.19.1
- pytest ==8.3.5
- requests ==2.32.3
- roman-numerals-py ==3.1.0
- ruff ==0.11.7
- sniffio ==1.3.1
- snowballstemmer ==2.2.0
- sphinx ==8.2.3
- sphinx-autobuild ==2024.10.3
- sphinx-press-theme ==0.9.1
- sphinxcontrib-applehelp ==2.0.0
- sphinxcontrib-devhelp ==2.0.0
- sphinxcontrib-htmlhelp ==2.1.0
- sphinxcontrib-jsmath ==1.0.1
- sphinxcontrib-qthelp ==2.0.0
- sphinxcontrib-serializinghtml ==2.0.0
- stack-data ==0.6.3
- starlette ==0.46.2
- traitlets ==5.14.3
- typing-extensions ==4.13.2
- urllib3 ==2.4.0
- uvicorn ==0.34.2
- watchfiles ==1.0.5
- wcwidth ==0.2.13
- websockets ==15.0.1
- click >=8.1.8
- perception-models *
- pillow >=11.0.0
- rich >=14.0.0
- torch ==2.5.1
- torchaudio ==2.5.1
- torchcodec ==0.1
- torchvision ==0.20.1
- xformers >=0.0.29.post1
- 194 dependencies