Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, distributed swarm intelligence, RAG integration, and native Claude Code support via MCP protocol. Ranked #1 in agent-based frameworks.

License

Notifications You must be signed in to change notification settings

ruvnet/claude-flow

Open more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌊 Claude-Flow v2.7.0: Enterprise AI Orchestration Platform

🌟 Star on GitHub πŸ“ˆ Downloads πŸ“¦ Latest Release ⚑ Claude Code πŸ›οΈ Agentics Foundation πŸ›‘οΈ MIT License

🌟 Overview

Claude-Flow v2.7 is an enterprise-grade AI orchestration platform that combines hive-mind swarm intelligence, persistent memory, and 100+ advanced MCP tools to revolutionize AI-powered development workflows.

🎯 Key Features

  • 🎨 25 Claude Skills: Natural language-activated skills for development, GitHub, memory, and automation
  • πŸš€ AgentDB v1.3.9 Integration: 96x-164x faster vector search with semantic understanding (PR #830)
  • 🧠 Hybrid Memory System: AgentDB + ReasoningBank with automatic fallback
  • πŸ” Semantic Vector Search: HNSW indexing (O(log n)) + 9 RL algorithms
  • 🐝 Hive-Mind Intelligence: Queen-led AI coordination with specialized worker agents
  • πŸ”§ 100 MCP Tools: Comprehensive toolkit for swarm orchestration and automation
  • πŸ”„ Dynamic Agent Architecture (DAA): Self-organizing agents with fault tolerance
  • πŸ’Ύ Persistent Memory: 150x faster search, 4-32x memory reduction (quantization)
  • πŸͺ Advanced Hooks System: Automated workflows with pre/post operation hooks
  • πŸ“Š GitHub Integration: 6 specialized modes for repository management
  • 🌐 Flow Nexus Cloud: E2B sandboxes, AI swarms, challenges, and marketplace

πŸ”₯ Revolutionary AI Coordination: Build faster, smarter, and more efficiently with AI-powered development orchestration

πŸ†• NEW: AgentDB Integration: 96x-164x performance boost with semantic vector search, reflexion memory, and skill library auto-consolidation


⚑ Quick Start

πŸ“‹ Prerequisites

  • Node.js 18+ (LTS recommended)
  • npm 9+ or equivalent package manager
  • Windows users: See Windows Installation Guide for special instructions

⚠️ IMPORTANT: Claude Code must be installed first:

# 1. Install Claude Code globally
npm install -g @anthropic-ai/claude-code

# 2. (Optional) Skip permissions check for faster setup
claude --dangerously-skip-permissions

πŸš€ Install Latest Alpha

# NPX (recommended - always latest)
npx claude-flow@alpha init --force
npx claude-flow@alpha --help

# Or install globally
npm install -g claude-flow@alpha
claude-flow --version
# v2.7.0-alpha.10

🎨 Skills System

Claude-Flow includes 25 specialized skills that activate automatically via natural language - no commands to memorize:

# Just describe what you want - skills activate automatically
"Let's pair program on this feature"        β†’ pair-programming skill
"Review this PR for security issues"       β†’ github-code-review skill
"Use vector search to find similar code"   β†’ agentdb-vector-search skill
"Create a swarm to build this API"         β†’ swarm-orchestration skill

Skill Categories:

  • Development & Methodology (3) - SPARC, pair programming, skill builder
  • Intelligence & Memory (6) - AgentDB integration with 150x-12,500x performance
  • Swarm Coordination (3) - Multi-agent orchestration and hive-mind
  • GitHub Integration (5) - PR review, workflows, releases, multi-repo
  • Automation & Quality (4) - Hooks, verification, performance analysis
  • Flow Nexus Platform (3) - Cloud sandboxes and neural training

πŸ“š Complete Skills Tutorial - Full guide with usage examples


πŸ†• What's New in v2.7.0-alpha.10

βœ… Semantic Search Fixed

Critical bug fix for semantic search returning 0 results:

  • βœ… Fixed stale compiled code (dist-cjs/ now uses Node.js backend)
  • βœ… Fixed result mapping for retrieveMemories() flat structure
  • βœ… Fixed parameter mismatch (namespace vs domain)
  • βœ… 2-3ms query latency with hash embeddings
  • βœ… Works without API keys (deterministic 1024-dim embeddings)

🧠 ReasoningBank Integration (agentic-flow@1.5.13)

  • Node.js Backend: Replaced WASM with SQLite + better-sqlite3
  • Persistent Storage: All memories saved to .swarm/memory.db
  • Semantic Search: MMR ranking with 4-factor scoring
  • Database Tables: patterns, embeddings, trajectories, links
  • Performance: 2ms queries, 400KB per pattern with embeddings
# Semantic search now fully functional
npx claude-flow@alpha memory store test "API configuration" --namespace semantic --reasoningbank
npx claude-flow@alpha memory query "configuration" --namespace semantic --reasoningbank
# βœ… Found 3 results (semantic search) in 2ms

πŸ“š Release Notes: v2.7.0-alpha.10

🧠 Memory System Commands

πŸš€ NEW: AgentDB v1.3.9 Integration (96x-164x Performance Boost)

Revolutionary Performance Improvements:

  • Vector Search: 96x faster (9.6ms β†’ <0.1ms)
  • Batch Operations: 125x faster
  • Large Queries: 164x faster
  • Memory Usage: 4-32x reduction via quantization
# Semantic vector search (understands meaning, not just keywords)
npx claude-flow@alpha memory vector-search "user authentication flow" \
  --k 10 --threshold 0.7 --namespace backend

# Store with vector embedding for semantic search
npx claude-flow@alpha memory store-vector api_design "REST endpoints" \
  --namespace backend --metadata '{"version":"v2"}'

# Get AgentDB integration status and capabilities
npx claude-flow@alpha memory agentdb-info

# Installation (hybrid mode - 100% backward compatible)
npm install agentdb@1.3.9

New Features:

  • βœ… Semantic vector search (HNSW indexing, O(log n))
  • βœ… 9 RL algorithms (Q-Learning, PPO, MCTS, Decision Transformer)
  • βœ… Reflexion memory (learn from past experiences)
  • βœ… Skill library (auto-consolidate successful patterns)
  • βœ… Causal reasoning (understand cause-effect relationships)
  • βœ… Quantization (binary 32x, scalar 4x, product 8-16x reduction)
  • βœ… 100% backward compatible (hybrid mode with graceful fallback)

Documentation: docs/agentdb/PRODUCTION_READINESS.md | PR: #830


ReasoningBank (Legacy SQLite Memory - Still Supported)

# Store memories with pattern matching
npx claude-flow@alpha memory store api_key "REST API configuration" \
  --namespace backend --reasoningbank

# Query with pattern search (2-3ms latency)
npx claude-flow@alpha memory query "API config" \
  --namespace backend --reasoningbank
# βœ… Found 3 results (pattern matching)

# List all memories
npx claude-flow@alpha memory list --namespace backend --reasoningbank

# Check status and statistics
npx claude-flow@alpha memory status --reasoningbank
# βœ… Total memories: 30
#    Embeddings: 30
#    Storage: .swarm/memory.db

Features:

  • βœ… No API Keys Required: Hash-based embeddings (1024 dimensions)
  • βœ… Persistent Storage: SQLite database survives restarts
  • βœ… Pattern Matching: LIKE-based search with similarity scoring
  • βœ… Namespace Isolation: Organize memories by domain
  • βœ… Fast Queries: 2-3ms average latency
  • βœ… Process Cleanup: Automatic database closing

Optional Enhanced Embeddings:

# For better semantic accuracy with text-embedding-3-small (1536 dimensions)
# Set OPENAI environment variable (see ReasoningBank documentation)

🐝 Swarm Orchestration

Quick Swarm Commands

# Quick task execution (recommended)
npx claude-flow@alpha swarm "build REST API with authentication" --claude

# Multi-agent coordination
npx claude-flow@alpha swarm init --topology mesh --max-agents 5
npx claude-flow@alpha swarm spawn researcher "analyze API patterns"
npx claude-flow@alpha swarm spawn coder "implement endpoints"
npx claude-flow@alpha swarm status

Hive-Mind for Complex Projects

# Initialize hive-mind system
npx claude-flow@alpha hive-mind wizard
npx claude-flow@alpha hive-mind spawn "build enterprise system" --claude

# Session management
npx claude-flow@alpha hive-mind status
npx claude-flow@alpha hive-mind resume session-xxxxx

When to Use:

Feature swarm hive-mind
Best For Quick tasks Complex projects
Setup Instant Interactive wizard
Memory Task-scoped Project-wide SQLite
Sessions Temporary Persistent + resume

πŸ”§ MCP Tools Integration

Setup MCP Servers

# Add Claude Flow MCP server (required)
claude mcp add claude-flow npx claude-flow@alpha mcp start

# Optional: Enhanced coordination
claude mcp add ruv-swarm npx ruv-swarm mcp start

# Optional: Cloud features (requires registration)
claude mcp add flow-nexus npx flow-nexus@latest mcp start

Available MCP Tools (100 Total)

Core Tools:

  • swarm_init, agent_spawn, task_orchestrate
  • memory_usage, memory_search
  • neural_status, neural_train, neural_patterns

Memory Tools:

  • mcp__claude-flow__memory_usage - Store/retrieve persistent memory
  • mcp__claude-flow__memory_search - Pattern-based search

GitHub Tools:

  • github_repo_analyze, github_pr_manage, github_issue_track

Performance Tools:

  • benchmark_run, performance_report, bottleneck_analyze

πŸ“š Full Reference: MCP Tools Documentation


πŸͺ Advanced Hooks System

Automated Workflow Enhancement

Claude-Flow automatically configures hooks for enhanced operations:

# Auto-configures hooks during init
npx claude-flow@alpha init --force

Available Hooks

Pre-Operation:

  • pre-task: Auto-assigns agents by complexity
  • pre-edit: Validates files and prepares resources
  • pre-command: Security validation

Post-Operation:

  • post-edit: Auto-formats code
  • post-task: Trains neural patterns
  • post-command: Updates memory

Session Management:

  • session-start: Restores previous context
  • session-end: Generates summaries
  • session-restore: Loads memory

🎯 Common Workflows

Pattern 1: Single Feature Development

# Initialize once per feature
npx claude-flow@alpha init --force
npx claude-flow@alpha hive-mind spawn "Implement authentication" --claude

# Continue same feature (reuse hive)
npx claude-flow@alpha memory query "auth" --recent
npx claude-flow@alpha swarm "Add password reset" --continue-session

Pattern 2: Multi-Feature Project

# Project initialization
npx claude-flow@alpha init --force --project-name "my-app"

# Feature 1: Authentication
npx claude-flow@alpha hive-mind spawn "auth-system" --namespace auth --claude

# Feature 2: User management
npx claude-flow@alpha hive-mind spawn "user-mgmt" --namespace users --claude

Pattern 3: Research & Analysis

# Start research session
npx claude-flow@alpha hive-mind spawn "Research microservices" \
  --agents researcher,analyst --claude

# Check learned knowledge
npx claude-flow@alpha memory stats
npx claude-flow@alpha memory query "microservices patterns" --reasoningbank

πŸ“Š Performance & Stats

  • 84.8% SWE-Bench solve rate - Industry-leading problem-solving
  • 32.3% token reduction - Efficient context management
  • 2.8-4.4x speed improvement - Parallel coordination
  • 96x-164x faster search - πŸ†• AgentDB vector search (9.6ms β†’ <0.1ms)
  • 4-32x memory reduction - πŸ†• AgentDB quantization
  • 2-3ms query latency - ReasoningBank pattern search (legacy)
  • 64 specialized agents - Complete development ecosystem
  • 100 MCP tools - Comprehensive automation toolkit
  • 180 AgentDB tests - >90% coverage, production-ready

πŸ“š Documentation

πŸ“– Core Documentation

πŸš€ Release Notes & Changelogs

🧠 AgentDB Integration (96x-164x Performance Boost)

⚑ Performance & Quality

πŸ› οΈ Advanced Topics

βš™οΈ Configuration & Setup


🀝 Community & Support


πŸš€ Roadmap & Targets

Immediate (Q4 2025)

  • βœ… Semantic search fix (v2.7.0-alpha.10)
  • βœ… ReasoningBank Node.js backend
  • βœ… AgentDB v1.3.9 integration (PR #830) - 96x-164x performance boost
  • πŸ”„ AgentDB production deployment (Q4 2025)
  • πŸ”„ Enhanced embedding models
  • πŸ”„ Multi-user collaboration features

Q1 2026

  • Advanced neural pattern recognition
  • Cloud swarm coordination
  • Real-time agent communication
  • Enterprise SSO integration

Growth Targets

  • 5K+ GitHub stars, 50K npm downloads/month
  • $25K MRR, 15 enterprise customers
  • 90%+ error prevention
  • 30+ minutes saved per developer per week

Star History

Star History Chart

πŸ“„ License

MIT License - see LICENSE for details


Built with ❀️ by rUv | Powered by Revolutionary AI

v2.7.0-alpha.10 - Semantic Search Fixed + ReasoningBank Node.js Backend

About

🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, distributed swarm intelligence, RAG integration, and native Claude Code support via MCP protocol. Ranked #1 in agent-based frameworks.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 11

Morty Proxy This is a proxified and sanitized view of the page, visit original site.