Liumi VectorCore 🚀

Sub‑2 ms SIMD‑accelerated INT8 vector search – zero‑copy .lvc format – runs entirely on‑device.

🎯 Why VectorCore?

📦 Installation

pip install lumi-vectorcore   # pulls the cp39‑abi3 wheel from PyPI

Note: The wheel contains only the stripped native library (vector_core.dll / .so / .dylib) and typed Python stubs – no source code.

🚀 Quick‑Start (Community Tier – ≤ 5 000 vectors)

from lumi_vectorcore import VectorCore, SearchResult

vc = VectorCore(dim=128)                 # 128‑dim INT8 vectors
vecs = [bytes([i % 256 for i in range(128)]) for _ in range(3000)]
vc.insert(vecs)                          # < 5 ms total

query = bytes([10] * 128)
hits: list[SearchResult] = vc.search(query, k=10)
for h in hits:
    print(h.id, h.distance)

🔓 Unlock Commercial Tier (unlimited vectors, multi‑threaded)

vc = VectorCore(dim=256, license_key="BASE64_KEY_FROM_LIUMI")
vc.insert(huge_corpus)   # millions of vectors, parallelised internally

The key is verified offline – no network call ever.

📄 Persistence – Zero‑Copy .lvc

# Save
blob = vc.save_lvc()
with open("my_index.lvc", "wb") as f:
    f.write(blob)

# Load (mmap‑backed, instant)
with open("my_index.lvc", "rb") as f:
    vc2 = VectorCore.from_bytes(f.read())

📜 License

See LICENSE.txt – proprietary commercial EULA with a free Community tier.

🤝 Community vs Commercial

📈 Benchmarks (single‑core, Intel i7‑12700K)

All numbers measured with time.perf_counter on a cold mmap load.

🙋 Support / Contact

• Issues: GitHub → LiumiCorp/VectorCore (public tracker)
• Commercial enquiries: sales@liumi.io
• Security: security@liumi.io (GPG‑encrypted)

Liumi Corporation – “AI on the edge, at the speed of silicon.”