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

rUvae1bd7a7ddab
diff --git a/README.md b/README.md
index e8dc4d30f1..9155663266 100644
--- a/README.md
+++ b/README.md
@@ -404,7 +404,7 @@ swarm_init({
### Prerequisites
-- **Node.js 18+** or **Bun 1.0+** (Bun is faster)
+- **Node.js 20+** (required)
- **npm 9+** / **pnpm** / **bun** package manager
**IMPORTANT**: Claude Code must be installed first:
@@ -419,23 +419,56 @@ claude --dangerously-skip-permissions
### Installation
+#### One-Line Install (Recommended)
+
```bash
-# With npm/npx (Node.js)
-npm install claude-flow@v3alpha
-npx claude-flow@v3alpha init
+# curl-style installer with progress display
+curl -fsSL https://raw.githubusercontent.com/ruvnet/claude-flow/main/scripts/install.sh | bash
+
+# Or with options:
+CLAUDE_FLOW_GLOBAL=1 curl -fsSL https://raw.githubusercontent.com/ruvnet/claude-flow/main/scripts/install.sh | bash
+```
+
+#### npm/npx Install
+
+```bash
+# Quick start (no install needed)
+npx claude-flow@alpha init
+
+# Or install globally
+npm install -g claude-flow@alpha
+claude-flow init
# With Bun (faster)
-bun add claude-flow@v3alpha
-bunx claude-flow@v3alpha init
+bunx claude-flow@alpha init
+```
+
+#### Install Profiles
+
+| Profile | Size | Use Case |
+|---------|------|----------|
+| `--omit=optional` | ~340MB | Core features only |
+| Default | ~340MB | Standard install |
+
+```bash
+# Minimal install (skip ML/embeddings)
+npm install -g claude-flow@alpha --omit=optional
+```
+
+### Basic Usage
+
+```bash
+# Initialize project
+npx claude-flow@alpha init
# Start MCP server for Claude Code integration
-npx claude-flow@v3alpha mcp start
+npx claude-flow@alpha mcp start
# Run a task with agents
-npx claude-flow@v3alpha --agent coder --task "Implement user authentication"
+npx claude-flow@alpha --agent coder --task "Implement user authentication"
# List available agents
-npx claude-flow@v3alpha --list
+npx claude-flow@alpha --list
```
### Upgrading
diff --git a/package-lock.json b/package-lock.json
index c803619f5c..bc889ae005 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "claude-flow",
- "version": "3.0.0-alpha.181",
+ "version": "3.0.0-alpha.182",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "claude-flow",
- "version": "3.0.0-alpha.181",
+ "version": "3.0.0-alpha.182",
"license": "MIT",
"dependencies": {
"@claude-flow/plugin-gastown-bridge": "^0.1.0",
diff --git a/package.json b/package.json
index a179d2d73d..0a8ee4481e 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "claude-flow",
- "version": "3.0.0-alpha.181",
+ "version": "3.0.0-alpha.182",
"description": "Enterprise AI agent orchestration for Claude Code - Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
"main": "dist/index.js",
"type": "module",
diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.json
index a6ab50c64e..3f9da9c802 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.181",
+ "version": "3.0.0-alpha.182",
"type": "module",
"description": "Claude Flow CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
"main": "dist/src/index.js",
diff --git a/v3/package-lock.json b/v3/package-lock.json
index 132365fd60..ae3a4ca4ef 100644
--- a/v3/package-lock.json
+++ b/v3/package-lock.json
@@ -1789,18 +1789,13 @@
}
},
"@claude-flow/cli": {
- "version": "3.0.0-alpha.181",
+ "version": "3.0.0-alpha.182",
"license": "MIT",
"dependencies": {
"@claude-flow/aidefence": "^3.0.2",
- "@claude-flow/embeddings": "^3.0.0-alpha.12",
"@claude-flow/mcp": "^3.0.0-alpha.8",
- "@claude-flow/plugin-gastown-bridge": "^0.1.0",
"@claude-flow/shared": "^3.0.0-alpha.1",
- "@noble/ed25519": "^2.1.0",
- "@ruvector/attention": "^0.1.4",
- "@ruvector/learning-wasm": "^0.1.29",
- "@ruvector/sona": "^0.1.5"
+ "@noble/ed25519": "^2.1.0"
},
"bin": {
"claude-flow": "bin/cli.js",
@@ -1810,6 +1805,13 @@
"devDependencies": {
"typescript": "^5.3.0",
"vitest": "^4.0.16"
+ },
+ "optionalDependencies": {
+ "@claude-flow/embeddings": "^3.0.0-alpha.12",
+ "@claude-flow/plugin-gastown-bridge": "^0.1.0",
+ "@ruvector/attention": "^0.1.4",
+ "@ruvector/learning-wasm": "^0.1.29",
+ "@ruvector/sona": "^0.1.5"
}
},
"@claude-flow/deployment": {
@@ -2330,6 +2332,7 @@
"resolved": "https://registry.npmjs.org/@claude-flow/plugin-gastown-bridge/-/plugin-gastown-bridge-0.1.1.tgz",
"integrity": "sha512-Wv/UO4RLiiKa9i8NMxDsex0zXJvD1QyBTIk8XH9nB72Qr91GzkXH8w4z3xPgr1koWx1CwZyim4Q6+MD2l52y9g==",
"license": "MIT",
+ "optional": true,
"dependencies": {
"@iarna/toml": "^2.2.5",
"uuid": "^9.0.0",
@@ -2929,7 +2932,8 @@
"version": "2.2.5",
"resolved": "https://registry.npmjs.org/@iarna/toml/-/toml-2.2.5.tgz",
"integrity": "sha512-trnsAYxU3xnS1gPHPyU961coFyLkh4gAD/0zQ5mymY4yOZ+CYvsPqUbOFSw0aDM4y0tV7tiFxL/1XfXPNC6IPg==",
- "license": "ISC"
+ "license": "ISC",
+ "optional": true
},
"node_modules/@img/sharp-darwin-arm64": {
"version": "0.33.5",
@@ -6498,7 +6502,8 @@
"version": "0.1.29",
"resolved": "https://registry.npmjs.org/@ruvector/learning-wasm/-/learning-wasm-0.1.29.tgz",
"integrity": "sha512-W6Fd/jhIQVQ4Cr7vKtU1rwdM3SfgTSNUmZr3uIpt/xfsET6u2lxIBrcRyuKbkNRuweOJdb4C/scEAfiDt1OCTw==",
- "license": "MIT OR Apache-2.0"
+ "license": "MIT OR Apache-2.0",
+ "optional": true
},
"node_modules/@ruvector/router": {
"version": "0.1.26",
@@ -20078,6 +20083,7 @@
"https://github.com/sponsors/ctavan"
],
"license": "MIT",
+ "optional": true,
"bin": {
"uuid": "dist/bin/uuid"
}