symphony-coord  by GradientHQ

Decentralized agentic framework for emergent coordination

Created 2 months ago
853 stars

Top 41.4% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

Symphony-Coord is a decentralized multi-agent framework enabling emergent coordination in complex tasks. It targets researchers and developers building fault-tolerant agent systems, allowing roles and task assignments to emerge organically via online learning, eliminating the need for explicit configuration. Its adaptive, decentralized approach to agent selection and task decomposition offers robust performance.

How It Works

The framework uses a three-stage pipeline: Planning, Execution, and Voting. Planning decomposes queries into sub-tasks, using LinUCB for path selection. Execution employs beacon-guided routing and LinUCB for agent selection, with parallel Chain-of-Thought (CoT) execution. Voting aggregates multiple CoT responses for a robust final answer. This design avoids a central orchestrator, promoting fault tolerance and dynamic role emergence.

Quick Start & Requirements

Installation: Clone repo, set up Python venv, pip install -r requirements.txt, pip install -e .. Requirements: Python 3.9+ (3.10/3.11 recommended), 8GB RAM (16GB recommended), optional CUDA GPU (RTX 3060+). Real experiments require an OpenRouter API key (env var or .env). See docs/OPENROUTER_CONFIG_GUIDE.md for API setup.

Highlighted Details

  • Decentralized Architecture: Fault-tolerant, no central orchestrator.
  • Intelligent Task Routing: Beacon-based capability matching with LinUCB learning.
  • Advanced Reasoning: Multi-path CoT with majority voting.
  • Edge Optimization: Runs on consumer-grade GPUs (RTX 3060/4090, Jetson, M-series Macs).

Maintenance & Community

The provided README lacks specific details on maintainers, community channels (e.g., Discord, Slack), or a public roadmap.

Licensing & Compatibility

The README does not explicitly state the project's license or provide compatibility notes for commercial use.

Limitations & Caveats

Full functionality requires careful API key management. Troubleshooting sections indicate potential issues like CUDA memory errors, rate limiting, and configuration problems, suggesting production deployment may need further hardening. The framework is primarily research-oriented, evidenced by its extensive experiment suite.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
0
Star History
488 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.