Original en anglais: https://argusic.com/subject/zvec

zvec

Une base de données vectorielle légère, ultra-rapide et embarquée.

Fonctionnesource : GitHubpage d'accueilC++Apache-2.0commit 53c1bb60a0e5

C++, sous licence Apache-2.0. Le projet se décrit ainsi : agent skills, db, embedded, faiss, fts, fulltext search, hnsw et llm memory.

zvec fonctionne. Un agent Argusic l'a installé en 49,6 minutes et a rencontré 5 erreurs, toutes corrigées sans aide sur une machine propre sans GPU, et toute la session a été enregistrée.

Zvec v0.7.0 prebuilt wheel and from-source build both work: the Python SDK successfully creates vectors collections, inserts documents, and returns ranked similarity search results, and the 1543-test suite passes with zero failures.

Ce que l'agent a obtenu sur une machine propre, dans ses propres mots. Comment c'est mesuré

Mesuré par Argusic sur une machine vierge, à chaque fois. Chaque chiffre renvoie à ses preuves. Score Argusic de 95 sur 100 (la moyenne des scores des exécutions de ce projet).

En un coup d'œil

verdict
Fonctionne
Score Argusic
95 / 100
coût de l'exécution de vérification
0,29 USD (mesuré)
exécutions enregistrées
2
dernier test
étoiles
16 185
forks
1 018
issues ouvertes
99
observateurs
68
taille
10 MB
créé le
dernier push

Données du projet issues de GitHub, avec un lien en haut de cette page, mis à jour le . Données de test d'Argusic (CC BY 4.0) ; chaque chiffre renvoie à une page d'exécution avec le log complet, l'enregistrement et leurs empreintes sha256.

Ce qui a été mesuré

Tiré de l'exécution qui a décidé ce verdict. Chaque ligne est une valeur enregistrée, pas une estimation.

Temps perdu à cause de chaque échec lors du test de zvec, tiré de l'exécution enregistrée
Chaque barre est un échec enregistré par l'agent, avec le temps qu'il a coûté. Tiré de cette exécution, et de nulle part ailleurs.

Ce qui s'est mal passé, dans les mots de l'agent

Les propres mots de l'agent, le plus grave en premier, jamais réécrits en conseils.

  • Parallel build of _zvec.so fails because static lib targets (core_knn_flat_static, etc.) are not built before linking7,3 minutes
  • pybind11::module INTERFACE_INCLUDE_DIRECTORIES hard-codes /usr/include/python3.12 from sysconfig; system cmake 3.28 vs pip cmake 3.31 behaves differently5,8 minutes
  • Python.h includes <x86_64-linux-gnu/python3.12/pyconfig.h> which was not present2,7 minutes
  • python3.12-dev headers not installed - CMake/pybind11 FindPythonLibsNew resolves INCLUDEPY to /usr/include/python3.12 which doesn't exist2,5 minutes
  • Pip-installed Python wrapper layer v0.7.0 mismatched freshly-built _zvec.so API (tuple vs _Doc objects)0,5 minute
Temps d'installation
50 minutes
De la machine vierge à la fin
58 minutes
Erreurs rencontrées et corrigées
5 rencontrées, 5 corrigées sans aide humaine
Comment le résultat a été prouvé
python -m pytest python/tests/ --tb=line -n=0 returned 1543 passed, 15 skipped, 0 failed; python -c example from README returned correct sorted results
Tokens de modèle utilisés
1 440 696
Commit exact testé
53c1bb60a0e5
Image de conteneur
sha256:cdd920bce783

Ce qui n'a pas été mesuré

L'autre moitié, pour que vous voyiez exactement jusqu'où vont ces preuves. Une lacune est affichée comme une lacune et n'est jamais comblée.

Pic de mémoire GPU
cette exécution a eu lieu sur une machine CPU, il n'y avait donc pas de GPU à mesurer
Comportement sur une longue durée
chaque tentative utilise les réglages documentés les plus légers et un budget de temps fixe : on mesure donc s'il fonctionne, pas comment il tient sous la charge

La fin de l'enregistrement

Les dernières lignes de la session de terminal qui a décidé ce verdict, exactement telles qu'elles ont été enregistrées.

  "score": 0.30000001192092896,
  "fields": {},
  "vectors": {}
}, {
  "id": "doc_1",
  "score": 0.23000001907348633,
  "fields": {},
  "vectors": {}
}]
ZVEC WORKS
tokens used
1,440,696

Revoir toute la session, chaque commande depuis une machine propre jusqu'à ce point.

Comment le test a été mené

Un agent, un conteneur, aucune aide humaine. Il installe le projet comme l'indique sa propre documentation, l'exécute et corrige ce qui casse. Tout ce qui suit est enregistré tel que cela s'est passé : la session de terminal, le log et le commit exact. La méthode complète.

Points forts et limites

Des faits mesurés, pas des opinions. Comment ce site est rédigé.

Ce qui s'est bien passé

  • A atteint un état de fonctionnement sur une machine propre, avec la session enregistrée.
  • S'est remis des 5 erreurs sans intervention humaine, ce qui indique que les échecs sont assez bien documentés pour être résolus.
  • A fonctionné sans GPU, il n'en a donc pas besoin pour démarrer.
  • Sous licence Apache-2.0, selon son hébergeur.
  • Mesuré 2 fois, le résultat n'est donc pas un cas isolé.

Ce qui ne s'est pas bien passé, ou n'est pas connu

  • Installation en 49,6 minutes, plus lente que la médiane des 106 projets comparables mesurés par Argusic.

Sur les 107 projets agent-skills qu'Argusic a installés et chronométrés, zvec a été le 107e plus rapide à atteindre un état de fonctionnement, et 78 sur 107 en ont atteint un.

Pour quoi c'est un choix raisonnable

  • L'essayer sur un ordinateur portable ou un petit serveur : il a atteint un état de fonctionnement sans GPU.

Également testés, dans le même domaine

Chacun de ces projets a été installé et exécuté par Argusic sur une machine propre. Rien n'apparaît ici sans avoir été testé.

Historique des exécutions

testé partentativerésultatscorecoût USDdate
Argusic Runner2/3Fonctionne90,000,33
Argusic Runner1/3Fonctionne100,000,29

Sujets (depuis GitHub)

agent-skillsdbembeddedfaissftsfulltext-searchhnswllm-memorylocalragsearch-enginesemantic-searchsimilarity-searchvector-databasevector-db

Intégrer le badge

Markdown pour le README du projet. Il renvoie vers cette page ; conditions sur la page des conditions.

[![Tested by Argusic](https://argusic.com/badge/zvec.svg)](https://argusic.com/subject/zvec)

Questions

zvec fonctionne-t-il ?
Oui. zvec fonctionne. Argusic l'a installé et lancé sur une machine propre en 50 minutes, en rencontrant 5 erreurs en route, et a enregistré la session.
Comment Argusic a-t-il testé zvec ?
Sur une machine vierge et jetable, avec chaque commande enregistrée et le dépôt épinglé au commit 53c1bb60a0e5. 2 tentatives sont enregistrées, et la méthode complète se trouve sur la page de méthodologie.
Combien a coûté le test de zvec ?
L'exécution qui a produit ce verdict a coûté 0,29 USD : le coût réel du calcul et du modèle, pas un prix catalogue par million de tokens. Il est enregistré sur la page de cette exécution.
Combien de temps faut-il pour installer zvec ?
49,6 minutes lors de l'exécution qui a décidé ce verdict, d'une machine propre à un état de fonctionnement. Il s'agit d'une tentative mesurée, pas d'une moyenne.
zvec a-t-il besoin d'un GPU ?
Pas pour démarrer. Argusic a atteint un état de fonctionnement sur une machine sans GPU.
Qu'est-ce qui pose problème lors de l'installation de zvec ?
5 problèmes sont survenus lors de l'exécution enregistrée, et 5 ont été corrigés sans aide humaine. Chacun, avec le temps qu'il a coûté, est listé sur cette page.
Comment zvec se compare-t-il aux alternatives ?
Sur les 107 projets agent-skills qu'Argusic a installés et chronométrés, zvec a été le 107e plus rapide à atteindre un état de fonctionnement, et 78 sur 107 en ont atteint un.
Où sont les preuves pour zvec ?
Les 2 exécutions enregistrées se trouvent sur cette page, chacune avec un lien vers son log complet et son enregistrement du terminal, conservés avec une empreinte sha256 pour qu'ils ne puissent pas être modifiés discrètement.

Discussion