{"name":"ROMA: Recursive Open Meta-Agents for High-Performance Multi-Agent Systems","description":"ROMA is a powerful meta-agent framework designed for building high-performance multi-agent systems using recursive hierarchical structures. It simplifies complex problem-solving by breaking tasks into parallelizable components, offering transparent development and proven performance. This open-source framework is extensible, allowing developers to customize agents and benefit from community-driven improvements.","github":"https://github.com/sentient-agi/ROMA","url":"https://osrepos.com/repo/sentient-agi-roma","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/sentient-agi-roma","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/sentient-agi-roma.md","json":"https://osrepos.com/repo/sentient-agi-roma.json","topics":["Python","AI","Multi-Agent Systems","LLM Framework","DSPy","Open-Source","Agent Framework","Recursive Agents"],"keywords":["Python","AI","Multi-Agent Systems","LLM Framework","DSPy","Open-Source","Agent Framework","Recursive Agents"],"stars":null,"summary":"ROMA is a powerful meta-agent framework designed for building high-performance multi-agent systems using recursive hierarchical structures. It simplifies complex problem-solving by breaking tasks into parallelizable components, offering transparent development and proven performance. This open-source framework is extensible, allowing developers to customize agents and benefit from community-driven improvements.","content":"## Introduction\n\nROMA (Recursive Open Meta-Agents) is a powerful meta-agent framework designed to build high-performance multi-agent systems. It leverages recursive hierarchical structures to effectively solve complex problems by breaking them down into parallelizable components. This approach enables agents to tackle sophisticated reasoning challenges while maintaining transparency, making context engineering and iteration straightforward.\n\nThe core of ROMA operates on a recursive plan-execute loop:\n1.  **Atomizer**: Decides if a request is atomic (directly executable) or requires planning.\n2.  **Planner**: If planning is needed, the task is broken into smaller subtasks, which are then fed back into the Atomizer, creating a recursive process.\n3.  **Executors**: Handle atomic tasks, utilizing LLMs, APIs, or other agents.\n4.  **Aggregator**: Collects and integrates results from subtasks to produce the final answer for the parent task.\n5.  **Verifier** (Optional): Inspects the aggregated output against the original goal before delivery.\n\nROMA offers parallel problem-solving, transparent development with a clear structure for easy debugging, and proven performance, as demonstrated through its search agent's strong benchmark results. As an open-source and extensible platform, ROMA is built for community-driven development, allowing you to customize agents for specific needs.\n\n## Installation\n\nThe recommended way to set up ROMA for production-ready features, including persistence, API, and observability, is using Docker.\n\n**Prerequisites:**\n*   Docker & Docker Compose\n*   Python 3.12+ (for local development)\n*   [Just](https://github.com/casey/just){:target=\"_blank\"} command runner (optional, recommended)\n\n**Complete Setup with Docker:**\nThis single command builds Docker images, starts all services (PostgreSQL, MinIO, REST API), configures the environment, and optionally sets up S3 storage or E2B code execution.\n\nbash\njust setup\n\n\nYou can verify services are running by checking `curl http://localhost:8000/health`.\nRequired environment variables for LLM providers (e.g., `OPENROUTER_API_KEY`, `OPENAI_API_KEY`) are typically configured automatically by `just setup` or can be set manually.\n\n## Examples\n\nROMA's modular design allows for flexible orchestration. Here's a quick example mirroring a typical end-to-end workflow, showcasing how different modules can work with distinct models and strategies:\n\npython\nimport dspy\nfrom roma_dspy import Aggregator, Atomizer, Executor, Planner, Verifier, SubTask\nfrom roma_dspy.types import TaskType\n\n# Optional tool that the Executor may call\ndef get_weather(city: str) -> str:\n    \"\"\"Return a canned weather report for the city.\"\"\"\n    return f\"The weather in {city} is sunny.\"\n\n# Executor geared toward ReAct with a Fireworks model\nexecutor_lm = dspy.LM(\n    \"fireworks_ai/accounts/fireworks/models/kimi-k2-instruct-0905\",\n    temperature=0.7,\n    cache=True,\n)\nexecutor = Executor(\n    lm=executor_lm,\n    prediction_strategy=\"react\",\n    tools=[get_weather],\n    context_defaults={\"track_usage\": True},\n)\n\n# Atomizer decides when to branch into planning\natomizer = Atomizer(\n    lm=dspy.LM(\"openrouter/google/gemini-2.5-flash\", temperature=0.6, cache=False),\n    prediction_strategy=\"cot\",\n    context_defaults={\"track_usage\": True},\n)\n\n# Planner produces executable subtasks for non-atomic goals\nplanner = Planner(\n    lm=dspy.LM(\"openrouter/openai/gpt-4o-mini\", temperature=0.85, cache=True),\n    prediction_strategy=\"cot\",\n    context_defaults={\"track_usage\": True},\n)\n\naggregator = Aggregator(\n    lm=dspy.LM(\"openrouter/openai/gpt-4o-mini\", temperature=0.65),\n    prediction_strategy=\"cot\",\n)\n\nverifier = Verifier(\n    lm=dspy.LM(\"openrouter/openai/gpt-4o-mini\", temperature=0.0),\n)\n\ndef run_pipeline(goal: str) -> str:\n    atomized = atomizer.forward(goal)\n    if atomized.is_atomic or atomized.node_type.is_execute:\n        execution = executor.forward(goal)\n        candidate = execution.output\n    else:\n        plan = planner.forward(goal)\n        results = []\n        for idx, subtask in enumerate(plan.subtasks, start=1):\n            execution = executor.forward(subtask.goal)\n            results.append(\n                SubTask(\n                    goal=subtask.goal,\n                    task_type=subtask.task_type,\n                    dependencies=subtask.dependencies,\n                )\n            )\n        aggregated = aggregator.forward(goal, results)\n        candidate = aggregated.synthesized_result\n\n    verdict = verifier.forward(goal, candidate)\n    if verdict.verdict:\n        return candidate\n    return f\"Verifier flagged the output: {verdict.feedback or 'no feedback returned'}\"\n\nprint(run_pipeline(\"Plan a weekend in Barcelona and include a packing list.\"))\n\n\nThis example demonstrates how ROMA's modules, each potentially using different Language Models and prediction strategies, can be orchestrated to achieve complex goals.\n\n## Why Use ROMA?\n\nROMA stands out as a robust framework for building advanced AI agents due to several key advantages:\n\n*   **Parallel Problem Solving**: ROMA's recursive decomposition allows agents to work on different parts of complex tasks simultaneously, significantly improving efficiency and throughput.\n*   **Transparent Development**: The clear, hierarchical structure of ROMA makes it easy to understand, debug, and iterate on agent behaviors, simplifying context engineering.\n*   **Proven Performance**: The framework has demonstrated strong benchmark results, particularly with its search agent, across challenging datasets like SEAL-0, FRAMES, and SimpleQA, showcasing its effectiveness in fact-seeking and reasoning tasks.\n*   **Open-Source and Extensible**: ROMA is designed for community-driven development, providing a flexible and customizable platform where developers can build and adapt agents to their specific needs, benefiting from collective improvements.\n*   **DSPy Integration**: Built upon DSPy, ROMA leverages a declarative framework for prompting, planning, and tool integration, ensuring stable interfaces and powerful reasoning capabilities.\n*   **Comprehensive Toolkits**: It includes 9 built-in toolkits for various functionalities, from file operations and code execution to crypto data and web search, making agents highly versatile.\n\n## Links\n\n*   **GitHub Repository**: [sentient-agi/ROMA](https://github.com/sentient-agi/ROMA){:target=\"_blank\"}\n*   **Official Website**: [Sentient AGI](https://sentient.xyz/){:target=\"_blank\"}\n*   **Technical Blog Post**: [Recursive Open Meta-Agent](https://www.sentient.xyz/blog/recursive-open-meta-agent){:target=\"_blank\"}\n*   **Quick Start Guide**: Available within the [ROMA GitHub repository](https://github.com/sentient-agi/ROMA/blob/main/docs/QUICKSTART.md){:target=\"_blank\"}","metrics":{"detailViews":6,"githubClicks":2},"dates":{"published":null,"modified":"2025-11-23T12:01:03.000Z"}}