Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

Checkpoint: File edits

rUv31710a0ea99d
diff --git a/README.md b/README.md
index 29bc961426..821fa23bbc 100644
--- a/README.md
+++ b/README.md
@@ -3786,33 +3786,67 @@ docker run -d -p 5432:5432 ruvnet/ruvector-postgres
| **[@ruvector/graph-node](https://www.npmjs.com/package/@ruvector/graph-node)** | Graph DB with Cypher queries | 10x faster than WASM |
| **[@ruvector/rvlite](https://www.npmjs.com/package/@ruvector/rvlite)** | Standalone DB (SQL, SPARQL, Cypher) | All-in-one solution |
-### 🐘 RuVector Postgres β€” Centralized Learning & Coordination
+### 🐘 RuVector PostgreSQL β€” Enterprise Vector Database
-For production swarms requiring centralized state and coordination:
+**77+ SQL functions** for AI operations directly in PostgreSQL with ~61Β΅s search latency and 16,400 QPS.
```bash
-# Pull and run RuVector Postgres
+# Quick setup with CLI (recommended)
+npx claude-flow ruvector setup --output ./my-ruvector
+cd my-ruvector && docker-compose up -d
+
+# Or pull directly from Docker Hub
docker run -d \
--name ruvector-postgres \
-p 5432:5432 \
- -e POSTGRES_PASSWORD=ruvector \
- -v ruvector-data:/var/lib/postgresql/data \
+ -e POSTGRES_USER=claude \
+ -e POSTGRES_PASSWORD=claude-flow-test \
+ -e POSTGRES_DB=claude_flow \
ruvnet/ruvector-postgres
-# Configure Claude-Flow to use centralized backend
-npx claude-flow@v3alpha config set memory.backend postgres
-npx claude-flow@v3alpha config set memory.postgresUrl "postgresql://postgres:ruvector@localhost:5432/ruvector"
+# Migrate existing memory to PostgreSQL
+npx claude-flow ruvector import --input memory-export.json
+```
+
+**RuVector PostgreSQL vs pgvector:**
+
+| Feature | pgvector | RuVector PostgreSQL |
+|---------|----------|---------------------|
+| **SQL Functions** | ~10 basic | **77+ comprehensive** |
+| **Search Latency** | ~1ms | **~61Β΅s** |
+| **Throughput** | ~5K QPS | **16,400 QPS** |
+| **Attention Mechanisms** | ❌ None | **βœ… 39 types (self, multi-head, cross)** |
+| **GNN Operations** | ❌ None | **βœ… GAT, message passing** |
+| **Hyperbolic Embeddings** | ❌ None | **βœ… PoincarΓ©/Lorentz space** |
+| **Hybrid Search** | ❌ Manual | **βœ… BM25/TF-IDF built-in** |
+| **Local Embeddings** | ❌ None | **βœ… 6 fastembed models** |
+| **Self-Learning** | ❌ None | **βœ… GNN-based optimization** |
+| **SIMD Optimization** | Basic | **AVX-512/AVX2/NEON (~2x faster)** |
+
+**Key SQL Functions:**
+
+```sql
+-- Vector operations with HNSW indexing
+SELECT * FROM embeddings ORDER BY embedding <=> query_vec LIMIT 10;
+
+-- Hyperbolic embeddings for hierarchical data
+SELECT ruvector_poincare_distance(a, b, -1.0) AS distance;
+SELECT ruvector_mobius_add(a, b, -1.0) AS result;
+
+-- Cosine similarity
+SELECT cosine_similarity_arr(a, b) AS similarity;
```
-**Benefits of Centralized Postgres:**
+**Benefits over Local SQLite:**
-| Feature | Local SQLite | RuVector Postgres |
-|---------|--------------|-------------------|
+| Feature | Local SQLite | RuVector PostgreSQL |
+|---------|--------------|---------------------|
| **Multi-Agent Coordination** | Single machine | Distributed across hosts |
| **Pattern Sharing** | File-based | Real-time synchronized |
| **Learning Persistence** | Local only | Centralized, backed up |
| **Swarm Scale** | 15 agents | 100+ agents |
-| **Query Language** | Basic KV | Full SQL + pgvector |
+| **Query Language** | Basic KV | Full SQL + 77 functions |
+| **AI Operations** | External only | **In-database (attention, GNN)** |
<details>
<summary>⚑ <strong>@ruvector/attention</strong> β€” Flash Attention (2.49x-7.47x Speedup)</summary>
diff --git a/package-lock.json b/package-lock.json
index c139e1e321..966c17eb32 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "claude-flow",
- "version": "3.0.0-alpha.83",
+ "version": "3.0.0-alpha.85",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "claude-flow",
- "version": "3.0.0-alpha.83",
+ "version": "3.0.0-alpha.85",
"license": "MIT",
"dependencies": {
"agentdb": "2.0.0-alpha.3.4",
diff --git a/package.json b/package.json
index 64c3a4a935..8de1410103 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "claude-flow",
- "version": "3.0.0-alpha.83",
+ "version": "3.0.0-alpha.85",
"description": "Claude Flow V3 - Domain-Driven Design Architecture with 15-Agent Swarm Coordination",
"main": "dist/index.js",
"type": "module",
diff --git a/v3/@claude-flow/cli/README.md b/v3/@claude-flow/cli/README.md
index 05ae934e68..29bc961426 100644
--- a/v3/@claude-flow/cli/README.md
+++ b/v3/@claude-flow/cli/README.md
@@ -253,6 +253,7 @@ Smart routing skips expensive LLM calls when possible. Simple edits use WASM (fr
| **Hive Mind** | β›” Not available | 🐝 Queen-led swarms with collective intelligence, 3 queen types, 8 worker types |
| **Consensus** | β›” No multi-agent decisions | Byzantine fault-tolerant voting (f < n/3), weighted, majority |
| **Memory** | Session-only, no persistence | HNSW vector memory with 150x-12,500x faster retrieval |
+| **Vector Database** | β›” No native support | 🐘 RuVector PostgreSQL with 77+ SQL functions, ~61Β΅s search, 16,400 QPS |
| **Collective Memory** | β›” No shared knowledge | Shared knowledge base with LRU cache, SQLite persistence, 8 memory types |
| **Learning** | Static behavior, no adaptation | SONA self-learning with <0.05ms adaptation, improves over time |
| **Task Routing** | You decide which agent to use | Intelligent routing based on learned patterns (89% accuracy) |
@@ -340,10 +341,12 @@ Claude-Flow v3 introduces **self-learning neural capabilities** that no other ag
| Feature | Claude Flow v3 | CrewAI | LangGraph | AutoGen | Manus |
|---------|----------------|--------|-----------|---------|-------|
| **Vector Memory** | βœ… HNSW (150x faster) | β›” | Via plugins | β›” | β›” |
-| **Hyperbolic Embeddings** | βœ… PoincarΓ© ball | β›” | β›” | β›” | β›” |
+| **PostgreSQL Vector DB** | βœ… RuVector (77+ SQL functions, ~61Β΅s) | β›” | pgvector only | β›” | β›” |
+| **Hyperbolic Embeddings** | βœ… PoincarΓ© ball (native + SQL) | β›” | β›” | β›” | β›” |
| **Quantization** | βœ… Int8 (3.92x savings) | β›” | β›” | β›” | β›” |
-| **Persistent Memory** | βœ… SQLite + AgentDB | β›” | β›” | β›” | Limited |
+| **Persistent Memory** | βœ… SQLite + AgentDB + PostgreSQL | β›” | β›” | β›” | Limited |
| **Cross-Session Context** | βœ… Full restoration | β›” | β›” | β›” | β›” |
+| **GNN/Attention in SQL** | βœ… 39 attention mechanisms | β›” | β›” | β›” | β›” |
#### 🐝 Swarm & Coordination
@@ -379,7 +382,7 @@ Claude-Flow v3 introduces **self-learning neural capabilities** that no other ag
<details>
<summary>πŸš€ <strong>Key Differentiators</strong> β€” Self-learning, memory optimization, fault tolerance</summary>
-What makes Claude-Flow different from other agent frameworks? These 9 capabilities work together to create a system that learns from experience, runs efficiently on any hardware, and keeps working even when things go wrong.
+What makes Claude-Flow different from other agent frameworks? These 10 capabilities work together to create a system that learns from experience, runs efficiently on any hardware, and keeps working even when things go wrong.
| | Feature | What It Does | Technical Details |
|---|---------|--------------|-------------------|
@@ -392,6 +395,7 @@ What makes Claude-Flow different from other agent frameworks? These 9 capabiliti
| πŸ—œοΈ | **Int8 Quantization** | Converts 32-bit weights to 8-bit with minimal accuracy loss | 3.92x memory reduction with calibrated 8-bit integers |
| 🀝 | **Claims System** | Manages task ownership between humans and agents with handoff support | Work ownership with claim/release/handoff protocols |
| πŸ›‘οΈ | **Byzantine Consensus** | Coordinates agents even when some fail or return bad results | Fault-tolerant, handles up to 1/3 failing agents |
+| 🐘 | **RuVector PostgreSQL** | Enterprise-grade vector database with 77+ SQL functions for AI operations | ~61¡s search, 16,400 QPS, GNN/attention in SQL |
</details>
diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.json
index 03390f20ca..f51389b682 100644
--- a/v3/@claude-flow/cli/package.json
+++ b/v3/@claude-flow/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@claude-flow/cli",
- "version": "3.0.0-alpha.120",
+ "version": "3.0.0-alpha.122",
"type": "module",
"description": "CLI module - command parsing, prompts, output formatting",
"main": "dist/src/index.js",
diff --git a/v3/package-lock.json b/v3/package-lock.json
index 1df6a8002a..c449556730 100644
--- a/v3/package-lock.json
+++ b/v3/package-lock.json
@@ -925,7 +925,7 @@
}
},
"@claude-flow/cli": {
- "version": "3.0.0-alpha.120",
+ "version": "3.0.0-alpha.122",
"dependencies": {
"@claude-flow/aidefence": "^3.0.2",
"@claude-flow/embeddings": "^3.0.0-alpha.12",