agentic-flow  by ruvnet

AI agent framework for faster, smarter, and cost-optimized autonomous workflows

Created 1 year ago
337 stars

Top 81.8% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

Agentic Flow addresses the common AI agent issues of slowness, forgetfulness, and high operational costs. It provides a framework for building AI agents that become faster and smarter with each use, targeting developers familiar with AI agent SDKs who need to deploy robust, cost-effective agents for business applications. The primary benefit is a significant performance revolution, offering drastically reduced latency, improved accuracy, and substantial cost savings compared to traditional agent implementations.

How It Works

The framework employs a modular architecture featuring several core components designed for performance and intelligence. The Agent Booster utilizes Rust/WASM for ultra-fast, local code transformations, achieving near-instantaneous edits. ReasoningBank provides a persistent learning memory system with semantic search, enabling agents to retain knowledge and improve accuracy over time. A Multi-Model Router intelligently selects from over 100 LLMs to optimize for cost, speed, or quality based on task requirements. Communication is enhanced by QUIC Transport for low-latency connections, while Federation Hub allows ephemeral agents to share memory, and Swarm Optimization enables self-learning parallel execution.

Quick Start & Requirements

Installation is straightforward via npm: npm install -g agentic-flow or direct execution with npx agentic-flow. A primary API key (e.g., ANTHROPIC_API_KEY or OPENROUTER_API_KEY) is required for cloud-based model access. Docker is recommended for production deployments. Links to official documentation are available within the README, with examples provided for CLI and programmatic usage.

Highlighted Details

  • Performance Revolution: Claims up to 352x faster code operations (1ms vs. 351ms per edit), 46% faster execution through learning, and 85-99% cost savings via model optimization.
  • Extensive Tooling: Integrates with claude-flow (101 tools), flow-nexus (96 cloud tools), OpenRouter (100+ LLMs), and ONNX Runtime for free local inference.
  • Advanced Features: Includes a Kubernetes GitOps controller leveraging Jujutsu VCS, a native Rust package (agentic-jujutsu) with experimental post-quantum cryptography, and specialized platforms for healthcare (Nova Medicina) and maternal health analysis.
  • Cost Optimization: The Multi-Model Router automatically selects optimal LLMs, offering significant savings (e.g., reducing code review costs from $240/month to $0/month).

Maintenance & Community

The project appears actively developed with recent additions like AgentDB v2, Federation Hub, and QUIC Transport. Support and discussions are primarily channeled through GitHub Issues and Discussions. Specific community links (Discord/Slack) are not provided in the README.

Licensing & Compatibility

The project is released under the MIT License, which generally permits commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

The post-quantum cryptography features in the agentic-jujutsu package are noted as placeholder implementations requiring further integration. Some components, like agentdb, are indicated as being in alpha status. Full functionality relies on external API keys, although ONNX Runtime offers a privacy-focused local inference option.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
16
Issues (30d)
7
Star History
80 stars in the last 30 days

Explore Similar Projects

Starred by Elie Bursztein Elie Bursztein(Cybersecurity Lead at Google DeepMind), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
7 more.

SuperAGI by TransformerOptimus

0.2%
17k
Open-source framework for autonomous AI agent development
Created 2 years ago
Updated 11 months ago
Feedback? Help us improve.