Skip to content

VectorForge v1.0.0 - Initial Release

Latest

Choose a tag to compare

@gitstq gitstq released this 07 Jun 15:10

πŸ”₯ VectorForge v1.0.0 - Initial Release

✨ Features

  • 4 Index Algorithms: HNSW, IVF-Flat, LSH, Brute-Force
  • 3 Distance Metrics: Cosine Similarity, Euclidean Distance, Dot Product
  • Index Persistence: JSON serialization/deserialization
  • Multi-Format I/O: JSON and CSV vector import/export
  • TUI Dashboard: Terminal-based index monitoring
  • Benchmark Module: Performance comparison across algorithms
  • CLI Tool: 6 subcommands (build, search, benchmark, dashboard, convert, generate)
  • High-Level API: Clean Python search interface
  • Zero Dependencies: Pure Python, no external packages required
  • Cross-Platform: Works on Windows, macOS, Linux

πŸ“¦ Installation

pip install git+https://github.com/gitstq/VectorForge.git

πŸš€ Quick Start

# Generate random vectors
vectorforge generate -n 1000 -d 128 -o vectors.json

# Build HNSW index
vectorforge build -t hnsw -d 128 -i vectors.json -o my_index.json

# Search
vectorforge search my_index.json -q "0.1,0.2,..." -k 10

# Benchmark all algorithms
vectorforge benchmark -n 1000 -d 64

πŸ§ͺ Tests

All 16 tests passing. Run with:

python tests/test_core.py
python tests/test_index.py

πŸ“„ License

MIT License