Skip to content

Instantly share code, notes, and snippets.

View ruvnet's full-sized avatar
πŸ’­
hacking the multiverse.

rUv ruvnet

πŸ’­
hacking the multiverse.
View GitHub Profile
@ruvnet
ruvnet / ruvector-residual-vq.md
Created May 16, 2026 07:38
ruvector 2026: Residual Vector Quantization (RVQ) β€” 64x memory compression, 14K QPS, pure Rust vector search with multi-codebook cascade quantization, ADC scoring, and beam-search encoding

ruvector 2026: Residual Vector Quantization β€” High-Performance Rust Vector Search

64Γ— memory compression. 14 000 QPS. Zero external dependencies. Pure Rust.

ruvector's new ruvector-residual-vq crate ships Residual Vector Quantization (RVQ) β€” the quantization scheme behind Meta's EnCodec, Google SoundStream, and LanceDB's default compressor since 2024 β€” as a standalone, dependency-light Rust library.

Introduction

@ruvnet
ruvnet / full-impl-gist.md
Created May 15, 2026 03:04
ADR-119 + ADR-120 full implementation β€” upstream midstreamer@0.3.1 + ruflo Steps 2 & 3 + alpha.38 (real QUIC, no stubs)

Full implementation: ADR-119 + ADR-120 β€” upstream midstreamer@0.3.1 + ruflo Step 2 + Step 3 + alpha.38

Shipped 2026-05-14. Real QUIC end-to-end, no stubs.

Layer Where Version
Upstream β€” midstreamer npm package ruvnet/midstream#81 merged 0.3.1 on npm
Ruflo β€” federation transport loader (Step 2) ruflo#2007 merged earlier today in alpha.37
Ruflo β€” Rust federation peer crate (Step 3) ruflo#2009 merged alpha.38
Release ruflo#2010 merged published
@ruvnet
ruvnet / adr-119-120-gist.md
Created May 15, 2026 02:32
ADR-119 + ADR-120 β€” midstreamer assessment + cross-port plan with QUIC from agentic-flow (ruflo alpha.37)

ADR-119 + ADR-120 β€” midstreamer adoption assessment + cross-port plan with QUIC from agentic-flow

Date: 2026-05-14 Β· Versions shipped: @claude-flow/cli@3.7.0-alpha.37, claude-flow@3.7.0-alpha.37, ruflo@3.7.0-alpha.37

Intro

ruvnet ships two related-but-distinct Rust workspaces: ruvnet/midstream (AIMDS safety gates + math/scheduling primitives) and ruvnet/agentic-flow (transport adapters, including QUIC). The names suggest overlap, and the question β€” can midstreamer give ruflo real QUIC + Tailscale-style networking + Rust in-flight agentics? β€” has come up enough times to deserve a written answer.

The short answer: midstreamer alone, no. midstreamer-quic (the underlying Rust crate, cross-pollinated with agentic-flow's bridge layer), yes β€” with a concrete three-step plan that lands in ruflo behind opt-in env flags.

@ruvnet
ruvnet / aidefence-2.3.0-gist.md
Created May 15, 2026 01:49
aidefence 2.3.0 / aimds-* 0.1.1 β€” what changed, what to do (ruflo ADR-118)

aidefence@2.3.0 + aimds-*@0.1.1 β€” what changed, what to do

Published 2026-05-14. Same MCP-tool surface, strictly better detection, accurate audit counters, one CVE cleared. If you're using aidefence_* MCP tools (the 3-gate pattern) through any ruflo plugin, you get the improvements automatically when the workspace package bumps.

Intro

aidefence (also published as aidefense β€” same code, two spellings) is the npm side of the AIMDS (AI Manipulation Defense System) project β€” a production-ready security middleware that protects AI applications from prompt injection, manipulation, PII leakage, and adversarial inputs. The library splits the defense into four latency tiers: detection (<10ms pattern matching + PII sanitization), behavioral analysis (<100ms anomaly + LTL policy checking), formal verification (<500ms theorem proving), and adaptive re

@ruvnet
ruvnet / gist-content.md
Last active May 14, 2026 19:13
neural-trader 2.7.6 post-mortem β€” 4 bugs, 3 fixed PRs, 3/5 platforms shipped

neural-trader post-mortem and 2.7.6 release notes

Audience: anyone who installed neural-trader between v2.5.0 (Nov 2025) and v2.7.5 (today) and wondered why nothing worked.

TL;DR

neural-trader@2.7.6 is on npm. It fixes a four-bug cascade that made the package nonfunctional from v2.5.0 onward:

  1. (Reported in ruflo#1974) An install-hook fork-bomb that consumed 120 GB of RAM in 80 minutes on Apple Silicon. Fixed in 2.7.2.
  2. A .gitignore mistake that silently dropped three load-bearing JS modules from the published tarball, so require('neural-trader') always threw Cannot find module. Fixed in 2.7.5.
@ruvnet
ruvnet / pi5-cluster-cookbook.md
Created May 13, 2026 12:43
Pi 5 + Hailo Cluster Cookbook β€” rvcsi Cognitive RF Observer (detailed reference for the RuView tutorial)

Pi 5 + Hailo Cluster Cookbook β€” rvcsi Cognitive RF Observer

Detailed reference companion to the RuView tutorial "Pi 5 + Hailo Cluster: Building a Cognitive RF Observer with rvcsi". This is the unabridged recipe β€” every command, every config, every unit file. The tutorial is the narrative; this is the manual.

Target cluster: 4Γ— Raspberry Pi 5 (8GB), 2Γ— Hailo-8 M.2 HAT, 1Γ— workstation (Linux, β‰₯16GB RAM), all on Tailscale.

@ruvnet
ruvnet / ruvector-ivf-pq-hakes-2026.md
Created May 13, 2026 07:45
ruvector IVF-PQ 2026: Rust vector search with 21x compression, 94.7% recall@10, 9481 QPS β€” product quantization ANN index

ruvector 2026: IVF-PQ with HAKES Filter-Refine β€” High-Performance Rust Vector Search

ruvector-ivfpq brings production-grade IVF-PQ (Inverted File Index + Product Quantization) to the Rust vector search ecosystem with 21Γ— memory compression and 94.7% recall@10 at 9,481 QPS.


Introduction

Vector search is the backbone of modern AI applications β€” RAG pipelines, semantic search, recommendation systems, and multimodal retrieval all depend on finding the nearest embedding vectors efficiently at scale. The challenge: at 10M+ vectors, brute-force exact search is too slow and graph-based indexes (HNSW, DiskANN) use too much memory.

@ruvnet
ruvnet / ruvector-rairs-ivf-2026.md
Last active May 12, 2026 13:45
ruvector-rairs: pure-Rust Inverted File index β€” redundant secondary-list assignment recovers +31.8pp recall@nprobe=1 vs IVFFlat at identical memory, no unsafe code

ruvector-rairs β€” a redundant-assignment Inverted File index for Rust ANN search

TL;DR β€” ruvector ships its first IVF (Inverted File) index β€” the search structure behind FAISS, Qdrant, and Milvus β€” in pure safe Rust (#![forbid(unsafe_code)], no C/BLAS, WASM-friendly). A redundant secondary-list assignment recovers the recall classic IVF loses near cluster boundaries: +31.8 percentage-point recall@10 at nprobe=1 over IVFFlat, at identical memory, thanks to a deduplicating shared-block layout. Auto-vectorised distance kernels push ~130k–270k single-thread QPS on a desktop x86-64 core.

Repository: https://github.com/ruvnet/ruvector
Crate: crates/ruvector-rairs Β· PR: ruvnet/RuVector#459
ADR: docs/adr/ADR-193-rairs-ivf.md

⚠️ Provenance. Early drafts of this work cited a "RAIRS / SEIL, Yang & Chen, SIGMOD 2026, arXiv:2601.07183" paper. That reference is unverified β€” treat the names as our own and the crate as an orig

@ruvnet
ruvnet / 2026-Q2-agentic-ai-and-edge-for-ruview.md
Created May 11, 2026 15:56
RuView β€” Agentic-AI breakthroughs & related RF/WiFi-sensing SOTA, 2026-Q2: survey + RuView-applicability mapping (ADRs 015/016/017/024/027/029-032/040/081/084-086/095/096)

Agentic-AI Breakthroughs & Related SOTA β€” Applicability to RuView (2026-Q2)

Status: Research note β€” non-binding survey. Nothing here is an accepted decision. Date: 2026-05-11 Β· Author: research pass (Claude Code) Β· Scope owner: ruv Companion docs: docs/research/sota/2026-Q2-rf-sensing-and-edge-rust.md, docs/research/sota-surveys/wifi-sensing-ruvector-sota-2026.md, docs/research/sota-surveys/ruview-multistatic-fidelity-sota-2026.md Maps onto ADRs: 015, 016, 017, 024, 027, 028, 029–032, 039, 040, 069, 081, 084–086, 095, 096


@ruvnet
ruvnet / hermes-agent-vs-ruflo-gap-analysis.md
Created May 11, 2026 14:17
Gap analysis: Nous Research Hermes Agent vs. Ruflo (claude-flow) β€” bidirectional capability comparison + strategic recommendations (2026-05-11)

Hermes Agent (Nous Research) vs. Ruflo β€” Gap Analysis

Date: 2026-05-11 Subjects: NousResearch/hermes-agent ("the agent that grows with you") vs. ruvnet/ruflo (formerly claude-flow, v3.6.x β€” "multi-agent AI orchestration for Claude Code") Type: Bidirectional capability gap analysis + strategic recommendations Evidence quality: Hermes facts sourced from its public README, docs site (hermes-agent.nousresearch.com/docs), and DeepWiki β€” the repo was not cloned, so tool/skill counts and module names are approximate. Ruflo facts sourced from its own README / CLAUDE.md / docs, which carry vendor-stated benchmarks (treat "89% routing accuracy", "150×–12,500Γ— search", etc. as claims, not independent measurements). Confidence: medium-high on architecture/positioning, medium on exact counts.


1. TL;DR