Metadata-Version: 2.4
Name: anvyonagentic
Version: 3.0.2
Summary: Open-source multi-agent framework for task decomposition, delegation, and execution
Author: Anvyon
License-Expression: AGPL-3.0-or-later
Project-URL: Homepage, https://www.anvyon.com
Project-URL: Documentation, https://github.com/anvyon1/Anvyonagentic#readme
Project-URL: Repository, https://github.com/anvyon1/Anvyonagentic
Project-URL: Issues, https://github.com/anvyon1/Anvyonagentic/issues
Project-URL: Changelog, https://github.com/anvyon1/Anvyonagentic/blob/main/CHANGELOG.md
Keywords: ai,agentic,task-optimization,delegation,multi-agent,llm
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.20.0; extra == "anthropic"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Provides-Extra: all
Requires-Dist: anthropic>=0.20.0; extra == "all"
Dynamic: license-file

# Anvyon Agentic

**Open-source multi-agent framework for task decomposition, delegation, and execution.**

Anvyon Agentic is a Python library for building multi-agent systems that decompose, delegate, and execute complex tasks. It provides a simple yet powerful foundation for agentic workflows with pluggable LLM providers.

[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)

## Features

- **Zero required dependencies** — core library uses only Python stdlib
- **Task decomposition** — break complex tasks into manageable subtasks via LLM
- **Agent registry** — register, list, and find agents by skill
- **Basic delegation** — create and manage delegation contracts
- **Executor routing** — route tasks to the right execution path (LLM or tool)
- **Built-in tools** — calculate, datetime, text_transform, json_parse, web_search
- **Pluggable LLM providers** — bring your own LLM or use the built-in Anthropic provider

> **Looking for advanced features?** For advanced capabilities that enable creating more efficient, less cost workflows we have embedded operations and OB principles into this. Additional features like PERT analysis, Monte Carlo simulation, RL optimization, trust calibration, oversight/governance, delegation memory, and human-in-the-loop approval are available in the **Anvyon Enterprise** package. Contact anvyon1@gmail.com and visit [www.anvyon.com](https://www.anvyon.com) for more details.

## Installation

```bash
pip install anvyonagentic
```

With Anthropic (Claude) support:

```bash
pip install anvyonagentic[anthropic]
```

For development:

```bash
pip install anvyonagentic[dev]
```

## Quick Start

```python
from anvyonagentic import Task, AgentRegistry, BasicOrchestrator, ToolRegistry

tasks = [
    Task(id="T1", description="Parse user input",
         optimistic=0.5, most_likely=1.0, pessimistic=2.0),
    Task(id="T2", description="Process data",
         optimistic=1.0, most_likely=2.0, pessimistic=3.0,
         depends_on=["T1"]),
]

registry = AgentRegistry()
agents = registry.find_by_skill("reasoning")
print(f"Found agent: {agents[0].name}")

orchestrator = BasicOrchestrator()
results = orchestrator.run(tasks)
print(results)

tools = ToolRegistry()
result = tools.execute("calculate", {"expression": "2 + 2 * 3"})
print(result)
```

## Architecture

### Modules

| Module | Description |
|---|---|
| `anvyonagentic.core` | Task, AgentRegistry, BasicOrchestrator |
| `anvyonagentic.router` | ExecutorRouter, DelegationManager |
| `anvyonagentic.tools` | ToolRegistry with built-in tools |

### Default Agents

| Agent | Type | Skills |
|---|---|---|
| `llm_reasoner` | llm | reasoning, analysis, text generation, planning |
| `tool_executor` | tool | calculation, data processing, JSON parsing |
| `code_agent` | llm | coding, debugging, testing, code review |
| `research_agent` | hybrid | search, research, fact-checking |

## Advanced Usage

### Custom Agents

```python
from anvyonagentic import AgentRegistry, WorkerAgent

registry = AgentRegistry()

registry.register(WorkerAgent(
    name="sql_expert",
    skills=["sql", "database", "query_optimization"],
    agent_type="tool",
    description="Specialized SQL and database agent"
))

agents = registry.find_by_skill("database")
print(f"Found agent: {agents[0].name}")
```

### Built-in Tools

```python
from anvyonagentic import ToolRegistry

tools = ToolRegistry()

result = tools.execute("calculate", {"expression": "2 + 2 * 3"})
print(result)  # {"success": True, "data": {"result": 8}}

result = tools.execute("datetime", {"format": "iso"})
result = tools.execute("text_transform", {"text": "hello", "operation": "upper"})
```

## Enterprise Features

For advanced capabilities that enable creating more efficient, less cost workflows we have embedded operations and OB principles into this. Additional features like PERT analysis, Monte Carlo simulation, RL optimization, trust calibration, oversight/governance, delegation memory, and human-in-the-loop approval are available in the **Anvyon Enterprise** package.

Contact anvyon1@gmail.com and visit [www.anvyon.com](https://www.anvyon.com) for more details.

## Contributing

Contributions are welcome. Please open an issue first to discuss what you would like to change.

```bash
git clone https://github.com/anvyon1/Anvyonagentic.git
cd anvyonagentic
pip install -e ".[dev]"
pytest
```

## License

This project is licensed under the **GNU Affero General Public License v3.0** (AGPL-3.0). See [LICENSE](LICENSE) for the full text.
