agenticaiframework 1.0.24__tar.gz → 1.0.26__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- agenticaiframework-1.0.26/PKG-INFO +161 -0
- agenticaiframework-1.0.26/README.md +138 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/memory.py +1 -1
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/processes.py +1 -1
- agenticaiframework-1.0.26/agenticaiframework.egg-info/PKG-INFO +161 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/setup.py +1 -1
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/tests/test_agenticai.py +2 -2
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/tests/test_agenticai_additional.py +11 -9
- agenticaiframework-1.0.24/PKG-INFO +0 -212
- agenticaiframework-1.0.24/README.md +0 -189
- agenticaiframework-1.0.24/agenticaiframework.egg-info/PKG-INFO +0 -212
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/LICENSE +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/__init__.py +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/agents.py +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/communication.py +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/configurations.py +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/evaluation.py +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/guardrails.py +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/hub.py +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/knowledge.py +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/llms.py +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/mcp_tools.py +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/monitoring.py +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/prompts.py +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/tasks.py +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework.egg-info/SOURCES.txt +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework.egg-info/dependency_links.txt +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework.egg-info/top_level.txt +0 -0
- {agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/setup.cfg +0 -0
@@ -0,0 +1,161 @@
|
|
1
|
+
Metadata-Version: 2.4
|
2
|
+
Name: agenticaiframework
|
3
|
+
Version: 1.0.26
|
4
|
+
Summary: AgenticAI - A Python SDK for building agentic applications with advanced orchestration, monitoring, and multimodal capabilities.
|
5
|
+
Home-page: https://github.com/isathish/AgenticAI
|
6
|
+
Author: Sathishkumar Nagarajan
|
7
|
+
Author-email: mail@sathishkumarnagarajan.com
|
8
|
+
Classifier: Programming Language :: Python :: 3
|
9
|
+
Classifier: License :: OSI Approved :: MIT License
|
10
|
+
Classifier: Operating System :: OS Independent
|
11
|
+
Requires-Python: >=3.7
|
12
|
+
Description-Content-Type: text/markdown
|
13
|
+
License-File: LICENSE
|
14
|
+
Dynamic: author
|
15
|
+
Dynamic: author-email
|
16
|
+
Dynamic: classifier
|
17
|
+
Dynamic: description
|
18
|
+
Dynamic: description-content-type
|
19
|
+
Dynamic: home-page
|
20
|
+
Dynamic: license-file
|
21
|
+
Dynamic: requires-python
|
22
|
+
Dynamic: summary
|
23
|
+
|
24
|
+
# 🌟 Agentic AI Framework
|
25
|
+
|
26
|
+
Agentic AI Framework (`agenticaiframework`) is a **next-generation Python SDK** for building **agentic applications** with advanced orchestration, monitoring, multimodal capabilities, and enterprise-grade scalability.
|
27
|
+
It offers a **modular, extensible architecture** for creating intelligent agents that can interact, reason, and execute tasks across multiple domains — from simple automation to complex multi-agent ecosystems.
|
28
|
+
|
29
|
+
---
|
30
|
+
|
31
|
+
## 🚀 Why Agentic AI Framework?
|
32
|
+
|
33
|
+
Unlike other frameworks such as **LangChain**, **CrewAI**, and **AutoGen**, Agentic AI Framework is designed to be:
|
34
|
+
|
35
|
+
- **Lightweight & High-Performance** — Minimal overhead with optimized execution for real-time and large-scale workloads.
|
36
|
+
- **Fully Modular** — Every component (agents, prompts, tools, guardrails, LLMs) is pluggable and replaceable.
|
37
|
+
- **Enterprise-Ready** — Built-in monitoring, guardrails, and compliance features for production environments.
|
38
|
+
- **Multimodal** — Supports text, images, audio, and video processing.
|
39
|
+
- **Cross-Platform** — Works seamlessly on cloud, on-premise, and edge devices.
|
40
|
+
- **Integration-Friendly** — Easy to connect with APIs, databases, and external tools.
|
41
|
+
- **Security-Focused** — Built-in guardrails, validation, and policy enforcement.
|
42
|
+
|
43
|
+
---
|
44
|
+
|
45
|
+
## 🔍 Feature Comparison
|
46
|
+
|
47
|
+
| Feature / Framework | Agentic AI Framework | LangChain | CrewAI | AutoGen |
|
48
|
+
|---------------------------|----------------------|-----------|--------|---------|
|
49
|
+
| Modular Architecture | ✅ Fully Modular | ⚠️ Partial| ⚠️ Partial | ⚠️ Partial |
|
50
|
+
| Multi-Agent Orchestration | ✅ Advanced | ✅ Basic | ✅ | ✅ |
|
51
|
+
| Built-in Guardrails | ✅ | ❌ | ⚠️ Limited | ❌ |
|
52
|
+
| Integrated Monitoring | ✅ | ❌ | ❌ | ❌ |
|
53
|
+
| Multimodal Support | ✅ Text/Image/Audio/Video | ⚠️ Limited| ❌ | ⚠️ Limited |
|
54
|
+
| Cross-Platform Deployment | ✅ | ⚠️ Limited| ❌ | ❌ |
|
55
|
+
| Memory Management | ✅ Short/Long/External | ✅ | ⚠️ Limited | ✅ |
|
56
|
+
| Process Orchestration | ✅ Sequential/Parallel/Hybrid | ⚠️ Limited| ✅ | ⚠️ Limited |
|
57
|
+
| Extensible Tooling | ✅ | ✅ | ⚠️ Limited | ⚠️ Limited |
|
58
|
+
| Security & Compliance | ✅ | ❌ | ❌ | ❌ |
|
59
|
+
| Knowledge Retrieval | ✅ | ⚠️ Limited| ❌ | ❌ |
|
60
|
+
| Evaluation System | ✅ | ❌ | ❌ | ❌ |
|
61
|
+
|
62
|
+
---
|
63
|
+
|
64
|
+
## ✨ Key Features
|
65
|
+
|
66
|
+
- **Agent Management** — Create, register, and control single or multiple agents.
|
67
|
+
- **Configuration Management** — Centralized configuration for all components.
|
68
|
+
- **Process Orchestration** — Sequential, parallel, and hybrid execution strategies.
|
69
|
+
- **Communication Layer** — Multiple protocols: HTTP, SSE, STDIO, WebSockets, gRPC, MQ.
|
70
|
+
- **Hub Architecture** — Central registry for agents, prompts, tools, and services.
|
71
|
+
- **Knowledge Retrieval** — Query and retrieve structured/unstructured knowledge.
|
72
|
+
- **Task Management** — Define, register, and execute tasks with inputs/outputs.
|
73
|
+
- **MCP Tools** — Modular tools with execution capabilities.
|
74
|
+
- **Prompt Management** — Create, store, and optimize prompts.
|
75
|
+
- **Monitoring System** — Metrics, events, and logs for observability.
|
76
|
+
- **Memory Management** — Short-term, long-term, and external memory storage.
|
77
|
+
- **Guardrails** — Validation and policy enforcement for safe execution.
|
78
|
+
- **LLM Management** — Register and use multiple LLMs with configurable parameters.
|
79
|
+
- **Evaluation System** — Define and run evaluation criteria for outputs.
|
80
|
+
- **Multimodal Capabilities** — Handle text, images, audio, and video.
|
81
|
+
- **Security & Compliance** — Built-in validation, logging, and policy enforcement.
|
82
|
+
|
83
|
+
---
|
84
|
+
|
85
|
+
## 📦 Installation
|
86
|
+
|
87
|
+
```bash
|
88
|
+
pip install agenticaiframework
|
89
|
+
```
|
90
|
+
|
91
|
+
---
|
92
|
+
|
93
|
+
## ⚡ Quick Start
|
94
|
+
|
95
|
+
```python
|
96
|
+
from agenticaiframework import Agent, AgentManager
|
97
|
+
|
98
|
+
# Create an agent
|
99
|
+
agent = Agent(
|
100
|
+
name="ExampleAgent",
|
101
|
+
role="assistant",
|
102
|
+
capabilities=["text"],
|
103
|
+
config={"temperature": 0.7}
|
104
|
+
)
|
105
|
+
|
106
|
+
# Manage agents
|
107
|
+
manager = AgentManager()
|
108
|
+
manager.register_agent(agent)
|
109
|
+
|
110
|
+
# Start the agent
|
111
|
+
agent.start()
|
112
|
+
```
|
113
|
+
|
114
|
+
---
|
115
|
+
|
116
|
+
## 📚 Examples
|
117
|
+
|
118
|
+
We provide **full working examples** for every module in the framework, including:
|
119
|
+
|
120
|
+
- Agent Management
|
121
|
+
- Configuration Management
|
122
|
+
- Processes (Basic & Advanced)
|
123
|
+
- Communication
|
124
|
+
- Hub
|
125
|
+
- Knowledge Retrieval
|
126
|
+
- Task Management
|
127
|
+
- MCP Tools
|
128
|
+
- Prompt Management
|
129
|
+
- Monitoring
|
130
|
+
- Memory Management
|
131
|
+
- Guardrails
|
132
|
+
- LLM Management
|
133
|
+
- Evaluation
|
134
|
+
|
135
|
+
See the [Full Examples Index](docs/examples/full_examples_index.md) for details.
|
136
|
+
|
137
|
+
---
|
138
|
+
|
139
|
+
## 📖 Documentation
|
140
|
+
|
141
|
+
Full documentation is available at: [https://isathish.github.io/agenticaiframework/](https://isathish.github.io/agenticaiframework/)
|
142
|
+
|
143
|
+
---
|
144
|
+
|
145
|
+
## 🧪 Testing
|
146
|
+
|
147
|
+
```bash
|
148
|
+
pytest
|
149
|
+
```
|
150
|
+
|
151
|
+
---
|
152
|
+
|
153
|
+
## 🤝 Contributing
|
154
|
+
|
155
|
+
We welcome contributions! Please see the contributing guidelines in the docs.
|
156
|
+
|
157
|
+
---
|
158
|
+
|
159
|
+
## 📄 License
|
160
|
+
|
161
|
+
MIT License - see the [LICENSE](LICENSE) file.
|
@@ -0,0 +1,138 @@
|
|
1
|
+
# 🌟 Agentic AI Framework
|
2
|
+
|
3
|
+
Agentic AI Framework (`agenticaiframework`) is a **next-generation Python SDK** for building **agentic applications** with advanced orchestration, monitoring, multimodal capabilities, and enterprise-grade scalability.
|
4
|
+
It offers a **modular, extensible architecture** for creating intelligent agents that can interact, reason, and execute tasks across multiple domains — from simple automation to complex multi-agent ecosystems.
|
5
|
+
|
6
|
+
---
|
7
|
+
|
8
|
+
## 🚀 Why Agentic AI Framework?
|
9
|
+
|
10
|
+
Unlike other frameworks such as **LangChain**, **CrewAI**, and **AutoGen**, Agentic AI Framework is designed to be:
|
11
|
+
|
12
|
+
- **Lightweight & High-Performance** — Minimal overhead with optimized execution for real-time and large-scale workloads.
|
13
|
+
- **Fully Modular** — Every component (agents, prompts, tools, guardrails, LLMs) is pluggable and replaceable.
|
14
|
+
- **Enterprise-Ready** — Built-in monitoring, guardrails, and compliance features for production environments.
|
15
|
+
- **Multimodal** — Supports text, images, audio, and video processing.
|
16
|
+
- **Cross-Platform** — Works seamlessly on cloud, on-premise, and edge devices.
|
17
|
+
- **Integration-Friendly** — Easy to connect with APIs, databases, and external tools.
|
18
|
+
- **Security-Focused** — Built-in guardrails, validation, and policy enforcement.
|
19
|
+
|
20
|
+
---
|
21
|
+
|
22
|
+
## 🔍 Feature Comparison
|
23
|
+
|
24
|
+
| Feature / Framework | Agentic AI Framework | LangChain | CrewAI | AutoGen |
|
25
|
+
|---------------------------|----------------------|-----------|--------|---------|
|
26
|
+
| Modular Architecture | ✅ Fully Modular | ⚠️ Partial| ⚠️ Partial | ⚠️ Partial |
|
27
|
+
| Multi-Agent Orchestration | ✅ Advanced | ✅ Basic | ✅ | ✅ |
|
28
|
+
| Built-in Guardrails | ✅ | ❌ | ⚠️ Limited | ❌ |
|
29
|
+
| Integrated Monitoring | ✅ | ❌ | ❌ | ❌ |
|
30
|
+
| Multimodal Support | ✅ Text/Image/Audio/Video | ⚠️ Limited| ❌ | ⚠️ Limited |
|
31
|
+
| Cross-Platform Deployment | ✅ | ⚠️ Limited| ❌ | ❌ |
|
32
|
+
| Memory Management | ✅ Short/Long/External | ✅ | ⚠️ Limited | ✅ |
|
33
|
+
| Process Orchestration | ✅ Sequential/Parallel/Hybrid | ⚠️ Limited| ✅ | ⚠️ Limited |
|
34
|
+
| Extensible Tooling | ✅ | ✅ | ⚠️ Limited | ⚠️ Limited |
|
35
|
+
| Security & Compliance | ✅ | ❌ | ❌ | ❌ |
|
36
|
+
| Knowledge Retrieval | ✅ | ⚠️ Limited| ❌ | ❌ |
|
37
|
+
| Evaluation System | ✅ | ❌ | ❌ | ❌ |
|
38
|
+
|
39
|
+
---
|
40
|
+
|
41
|
+
## ✨ Key Features
|
42
|
+
|
43
|
+
- **Agent Management** — Create, register, and control single or multiple agents.
|
44
|
+
- **Configuration Management** — Centralized configuration for all components.
|
45
|
+
- **Process Orchestration** — Sequential, parallel, and hybrid execution strategies.
|
46
|
+
- **Communication Layer** — Multiple protocols: HTTP, SSE, STDIO, WebSockets, gRPC, MQ.
|
47
|
+
- **Hub Architecture** — Central registry for agents, prompts, tools, and services.
|
48
|
+
- **Knowledge Retrieval** — Query and retrieve structured/unstructured knowledge.
|
49
|
+
- **Task Management** — Define, register, and execute tasks with inputs/outputs.
|
50
|
+
- **MCP Tools** — Modular tools with execution capabilities.
|
51
|
+
- **Prompt Management** — Create, store, and optimize prompts.
|
52
|
+
- **Monitoring System** — Metrics, events, and logs for observability.
|
53
|
+
- **Memory Management** — Short-term, long-term, and external memory storage.
|
54
|
+
- **Guardrails** — Validation and policy enforcement for safe execution.
|
55
|
+
- **LLM Management** — Register and use multiple LLMs with configurable parameters.
|
56
|
+
- **Evaluation System** — Define and run evaluation criteria for outputs.
|
57
|
+
- **Multimodal Capabilities** — Handle text, images, audio, and video.
|
58
|
+
- **Security & Compliance** — Built-in validation, logging, and policy enforcement.
|
59
|
+
|
60
|
+
---
|
61
|
+
|
62
|
+
## 📦 Installation
|
63
|
+
|
64
|
+
```bash
|
65
|
+
pip install agenticaiframework
|
66
|
+
```
|
67
|
+
|
68
|
+
---
|
69
|
+
|
70
|
+
## ⚡ Quick Start
|
71
|
+
|
72
|
+
```python
|
73
|
+
from agenticaiframework import Agent, AgentManager
|
74
|
+
|
75
|
+
# Create an agent
|
76
|
+
agent = Agent(
|
77
|
+
name="ExampleAgent",
|
78
|
+
role="assistant",
|
79
|
+
capabilities=["text"],
|
80
|
+
config={"temperature": 0.7}
|
81
|
+
)
|
82
|
+
|
83
|
+
# Manage agents
|
84
|
+
manager = AgentManager()
|
85
|
+
manager.register_agent(agent)
|
86
|
+
|
87
|
+
# Start the agent
|
88
|
+
agent.start()
|
89
|
+
```
|
90
|
+
|
91
|
+
---
|
92
|
+
|
93
|
+
## 📚 Examples
|
94
|
+
|
95
|
+
We provide **full working examples** for every module in the framework, including:
|
96
|
+
|
97
|
+
- Agent Management
|
98
|
+
- Configuration Management
|
99
|
+
- Processes (Basic & Advanced)
|
100
|
+
- Communication
|
101
|
+
- Hub
|
102
|
+
- Knowledge Retrieval
|
103
|
+
- Task Management
|
104
|
+
- MCP Tools
|
105
|
+
- Prompt Management
|
106
|
+
- Monitoring
|
107
|
+
- Memory Management
|
108
|
+
- Guardrails
|
109
|
+
- LLM Management
|
110
|
+
- Evaluation
|
111
|
+
|
112
|
+
See the [Full Examples Index](docs/examples/full_examples_index.md) for details.
|
113
|
+
|
114
|
+
---
|
115
|
+
|
116
|
+
## 📖 Documentation
|
117
|
+
|
118
|
+
Full documentation is available at: [https://isathish.github.io/agenticaiframework/](https://isathish.github.io/agenticaiframework/)
|
119
|
+
|
120
|
+
---
|
121
|
+
|
122
|
+
## 🧪 Testing
|
123
|
+
|
124
|
+
```bash
|
125
|
+
pytest
|
126
|
+
```
|
127
|
+
|
128
|
+
---
|
129
|
+
|
130
|
+
## 🤝 Contributing
|
131
|
+
|
132
|
+
We welcome contributions! Please see the contributing guidelines in the docs.
|
133
|
+
|
134
|
+
---
|
135
|
+
|
136
|
+
## 📄 License
|
137
|
+
|
138
|
+
MIT License - see the [LICENSE](LICENSE) file.
|
@@ -0,0 +1,161 @@
|
|
1
|
+
Metadata-Version: 2.4
|
2
|
+
Name: agenticaiframework
|
3
|
+
Version: 1.0.26
|
4
|
+
Summary: AgenticAI - A Python SDK for building agentic applications with advanced orchestration, monitoring, and multimodal capabilities.
|
5
|
+
Home-page: https://github.com/isathish/AgenticAI
|
6
|
+
Author: Sathishkumar Nagarajan
|
7
|
+
Author-email: mail@sathishkumarnagarajan.com
|
8
|
+
Classifier: Programming Language :: Python :: 3
|
9
|
+
Classifier: License :: OSI Approved :: MIT License
|
10
|
+
Classifier: Operating System :: OS Independent
|
11
|
+
Requires-Python: >=3.7
|
12
|
+
Description-Content-Type: text/markdown
|
13
|
+
License-File: LICENSE
|
14
|
+
Dynamic: author
|
15
|
+
Dynamic: author-email
|
16
|
+
Dynamic: classifier
|
17
|
+
Dynamic: description
|
18
|
+
Dynamic: description-content-type
|
19
|
+
Dynamic: home-page
|
20
|
+
Dynamic: license-file
|
21
|
+
Dynamic: requires-python
|
22
|
+
Dynamic: summary
|
23
|
+
|
24
|
+
# 🌟 Agentic AI Framework
|
25
|
+
|
26
|
+
Agentic AI Framework (`agenticaiframework`) is a **next-generation Python SDK** for building **agentic applications** with advanced orchestration, monitoring, multimodal capabilities, and enterprise-grade scalability.
|
27
|
+
It offers a **modular, extensible architecture** for creating intelligent agents that can interact, reason, and execute tasks across multiple domains — from simple automation to complex multi-agent ecosystems.
|
28
|
+
|
29
|
+
---
|
30
|
+
|
31
|
+
## 🚀 Why Agentic AI Framework?
|
32
|
+
|
33
|
+
Unlike other frameworks such as **LangChain**, **CrewAI**, and **AutoGen**, Agentic AI Framework is designed to be:
|
34
|
+
|
35
|
+
- **Lightweight & High-Performance** — Minimal overhead with optimized execution for real-time and large-scale workloads.
|
36
|
+
- **Fully Modular** — Every component (agents, prompts, tools, guardrails, LLMs) is pluggable and replaceable.
|
37
|
+
- **Enterprise-Ready** — Built-in monitoring, guardrails, and compliance features for production environments.
|
38
|
+
- **Multimodal** — Supports text, images, audio, and video processing.
|
39
|
+
- **Cross-Platform** — Works seamlessly on cloud, on-premise, and edge devices.
|
40
|
+
- **Integration-Friendly** — Easy to connect with APIs, databases, and external tools.
|
41
|
+
- **Security-Focused** — Built-in guardrails, validation, and policy enforcement.
|
42
|
+
|
43
|
+
---
|
44
|
+
|
45
|
+
## 🔍 Feature Comparison
|
46
|
+
|
47
|
+
| Feature / Framework | Agentic AI Framework | LangChain | CrewAI | AutoGen |
|
48
|
+
|---------------------------|----------------------|-----------|--------|---------|
|
49
|
+
| Modular Architecture | ✅ Fully Modular | ⚠️ Partial| ⚠️ Partial | ⚠️ Partial |
|
50
|
+
| Multi-Agent Orchestration | ✅ Advanced | ✅ Basic | ✅ | ✅ |
|
51
|
+
| Built-in Guardrails | ✅ | ❌ | ⚠️ Limited | ❌ |
|
52
|
+
| Integrated Monitoring | ✅ | ❌ | ❌ | ❌ |
|
53
|
+
| Multimodal Support | ✅ Text/Image/Audio/Video | ⚠️ Limited| ❌ | ⚠️ Limited |
|
54
|
+
| Cross-Platform Deployment | ✅ | ⚠️ Limited| ❌ | ❌ |
|
55
|
+
| Memory Management | ✅ Short/Long/External | ✅ | ⚠️ Limited | ✅ |
|
56
|
+
| Process Orchestration | ✅ Sequential/Parallel/Hybrid | ⚠️ Limited| ✅ | ⚠️ Limited |
|
57
|
+
| Extensible Tooling | ✅ | ✅ | ⚠️ Limited | ⚠️ Limited |
|
58
|
+
| Security & Compliance | ✅ | ❌ | ❌ | ❌ |
|
59
|
+
| Knowledge Retrieval | ✅ | ⚠️ Limited| ❌ | ❌ |
|
60
|
+
| Evaluation System | ✅ | ❌ | ❌ | ❌ |
|
61
|
+
|
62
|
+
---
|
63
|
+
|
64
|
+
## ✨ Key Features
|
65
|
+
|
66
|
+
- **Agent Management** — Create, register, and control single or multiple agents.
|
67
|
+
- **Configuration Management** — Centralized configuration for all components.
|
68
|
+
- **Process Orchestration** — Sequential, parallel, and hybrid execution strategies.
|
69
|
+
- **Communication Layer** — Multiple protocols: HTTP, SSE, STDIO, WebSockets, gRPC, MQ.
|
70
|
+
- **Hub Architecture** — Central registry for agents, prompts, tools, and services.
|
71
|
+
- **Knowledge Retrieval** — Query and retrieve structured/unstructured knowledge.
|
72
|
+
- **Task Management** — Define, register, and execute tasks with inputs/outputs.
|
73
|
+
- **MCP Tools** — Modular tools with execution capabilities.
|
74
|
+
- **Prompt Management** — Create, store, and optimize prompts.
|
75
|
+
- **Monitoring System** — Metrics, events, and logs for observability.
|
76
|
+
- **Memory Management** — Short-term, long-term, and external memory storage.
|
77
|
+
- **Guardrails** — Validation and policy enforcement for safe execution.
|
78
|
+
- **LLM Management** — Register and use multiple LLMs with configurable parameters.
|
79
|
+
- **Evaluation System** — Define and run evaluation criteria for outputs.
|
80
|
+
- **Multimodal Capabilities** — Handle text, images, audio, and video.
|
81
|
+
- **Security & Compliance** — Built-in validation, logging, and policy enforcement.
|
82
|
+
|
83
|
+
---
|
84
|
+
|
85
|
+
## 📦 Installation
|
86
|
+
|
87
|
+
```bash
|
88
|
+
pip install agenticaiframework
|
89
|
+
```
|
90
|
+
|
91
|
+
---
|
92
|
+
|
93
|
+
## ⚡ Quick Start
|
94
|
+
|
95
|
+
```python
|
96
|
+
from agenticaiframework import Agent, AgentManager
|
97
|
+
|
98
|
+
# Create an agent
|
99
|
+
agent = Agent(
|
100
|
+
name="ExampleAgent",
|
101
|
+
role="assistant",
|
102
|
+
capabilities=["text"],
|
103
|
+
config={"temperature": 0.7}
|
104
|
+
)
|
105
|
+
|
106
|
+
# Manage agents
|
107
|
+
manager = AgentManager()
|
108
|
+
manager.register_agent(agent)
|
109
|
+
|
110
|
+
# Start the agent
|
111
|
+
agent.start()
|
112
|
+
```
|
113
|
+
|
114
|
+
---
|
115
|
+
|
116
|
+
## 📚 Examples
|
117
|
+
|
118
|
+
We provide **full working examples** for every module in the framework, including:
|
119
|
+
|
120
|
+
- Agent Management
|
121
|
+
- Configuration Management
|
122
|
+
- Processes (Basic & Advanced)
|
123
|
+
- Communication
|
124
|
+
- Hub
|
125
|
+
- Knowledge Retrieval
|
126
|
+
- Task Management
|
127
|
+
- MCP Tools
|
128
|
+
- Prompt Management
|
129
|
+
- Monitoring
|
130
|
+
- Memory Management
|
131
|
+
- Guardrails
|
132
|
+
- LLM Management
|
133
|
+
- Evaluation
|
134
|
+
|
135
|
+
See the [Full Examples Index](docs/examples/full_examples_index.md) for details.
|
136
|
+
|
137
|
+
---
|
138
|
+
|
139
|
+
## 📖 Documentation
|
140
|
+
|
141
|
+
Full documentation is available at: [https://isathish.github.io/agenticaiframework/](https://isathish.github.io/agenticaiframework/)
|
142
|
+
|
143
|
+
---
|
144
|
+
|
145
|
+
## 🧪 Testing
|
146
|
+
|
147
|
+
```bash
|
148
|
+
pytest
|
149
|
+
```
|
150
|
+
|
151
|
+
---
|
152
|
+
|
153
|
+
## 🤝 Contributing
|
154
|
+
|
155
|
+
We welcome contributions! Please see the contributing guidelines in the docs.
|
156
|
+
|
157
|
+
---
|
158
|
+
|
159
|
+
## 📄 License
|
160
|
+
|
161
|
+
MIT License - see the [LICENSE](LICENSE) file.
|
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
|
|
2
2
|
|
3
3
|
setup(
|
4
4
|
name="agenticaiframework",
|
5
|
-
version="1.0.
|
5
|
+
version="1.0.26",
|
6
6
|
author="Sathishkumar Nagarajan",
|
7
7
|
author_email="mail@sathishkumarnagarajan.com",
|
8
8
|
description="AgenticAI - A Python SDK for building agentic applications with advanced orchestration, monitoring, and multimodal capabilities.",
|
@@ -1,5 +1,5 @@
|
|
1
|
-
import
|
2
|
-
import
|
1
|
+
import sys
|
2
|
+
import os
|
3
3
|
sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
|
4
4
|
|
5
5
|
from agenticaiframework.communication import CommunicationManager
|
@@ -12,7 +12,10 @@ from agenticaiframework.llms import LLMManager
|
|
12
12
|
|
13
13
|
def test_register_and_list_protocols(capsys):
|
14
14
|
cm = CommunicationManager()
|
15
|
-
|
15
|
+
|
16
|
+
def handler(data):
|
17
|
+
return f"Processed {data}"
|
18
|
+
|
16
19
|
cm.register_protocol("test", handler)
|
17
20
|
assert "test" in cm.list_protocols()
|
18
21
|
captured = capsys.readouterr()
|
@@ -172,7 +175,6 @@ def test_llm_manager_with_exception(capsys):
|
|
172
175
|
|
173
176
|
|
174
177
|
# Additional tests to improve coverage for mcp_tools, memory, and monitoring
|
175
|
-
|
176
178
|
from agenticaiframework.mcp_tools import MCPToolManager, MCPTool
|
177
179
|
from agenticaiframework.memory import MemoryManager
|
178
180
|
from agenticaiframework.monitoring import MonitoringSystem
|
@@ -264,7 +266,7 @@ def test_monitoring_system_log_and_metrics(capsys):
|
|
264
266
|
ms.log_event("evt1")
|
265
267
|
except TypeError:
|
266
268
|
try:
|
267
|
-
ms.log_event("evt1", {"info": "test"})
|
269
|
+
ms.log_event("evt1", {"info": "test"}) # type: ignore[call-arg]
|
268
270
|
except Exception:
|
269
271
|
pass
|
270
272
|
try:
|
@@ -280,13 +282,13 @@ def test_monitoring_system_alerts(capsys):
|
|
280
282
|
ms = MonitoringSystem()
|
281
283
|
try:
|
282
284
|
if hasattr(ms, "alert") and callable(getattr(ms, "alert")):
|
283
|
-
ms.alert("warn1")
|
284
|
-
assert "warn1" in getattr(ms, "alerts", [])
|
285
|
+
ms.alert("warn1") # type: ignore[attr-defined]
|
286
|
+
assert "warn1" in getattr(ms, "alerts", []) # type: ignore[attr-defined]
|
285
287
|
else:
|
286
288
|
# Fallback: simulate alert
|
287
|
-
setattr(ms, "alerts", ["warn1"])
|
289
|
+
setattr(ms, "alerts", ["warn1"]) # type: ignore[attr-defined]
|
288
290
|
print("ALERT: warn1")
|
289
291
|
except Exception:
|
290
292
|
pass
|
291
293
|
captured = capsys.readouterr()
|
292
|
-
assert "warn1" in captured.out or "warn1" in str(getattr(ms, "alerts", []))
|
294
|
+
assert "warn1" in captured.out or "warn1" in str(getattr(ms, "alerts", [])) # type: ignore[attr-defined]
|
@@ -1,212 +0,0 @@
|
|
1
|
-
Metadata-Version: 2.4
|
2
|
-
Name: agenticaiframework
|
3
|
-
Version: 1.0.24
|
4
|
-
Summary: AgenticAI - A Python SDK for building agentic applications with advanced orchestration, monitoring, and multimodal capabilities.
|
5
|
-
Home-page: https://github.com/isathish/AgenticAI
|
6
|
-
Author: Sathishkumar Nagarajan
|
7
|
-
Author-email: mail@sathishkumarnagarajan.com
|
8
|
-
Classifier: Programming Language :: Python :: 3
|
9
|
-
Classifier: License :: OSI Approved :: MIT License
|
10
|
-
Classifier: Operating System :: OS Independent
|
11
|
-
Requires-Python: >=3.7
|
12
|
-
Description-Content-Type: text/markdown
|
13
|
-
License-File: LICENSE
|
14
|
-
Dynamic: author
|
15
|
-
Dynamic: author-email
|
16
|
-
Dynamic: classifier
|
17
|
-
Dynamic: description
|
18
|
-
Dynamic: description-content-type
|
19
|
-
Dynamic: home-page
|
20
|
-
Dynamic: license-file
|
21
|
-
Dynamic: requires-python
|
22
|
-
Dynamic: summary
|
23
|
-
|
24
|
-
<!-- PROJECT LOGO -->
|
25
|
-
<br />
|
26
|
-
<div align="center">
|
27
|
-
<a href="https://isathish.github.io/agenticaiframework/">
|
28
|
-
<img src="https://img.shields.io/pypi/v/agenticaiframework?color=blue&label=PyPI%20Version&logo=python&logoColor=white" alt="PyPI Version">
|
29
|
-
</a>
|
30
|
-
<a href="https://pypi.org/project/agenticaiframework/">
|
31
|
-
<img src="https://img.shields.io/pypi/dm/agenticaiframework?color=green&label=Downloads&logo=python&logoColor=white" alt="Downloads">
|
32
|
-
</a>
|
33
|
-
<a href="https://github.com/isathish/agenticaiframework/actions">
|
34
|
-
<img src="https://img.shields.io/github/actions/workflow/status/isathish/agenticaiframework/python-package.yml?branch=main&label=Build&logo=github" alt="Build Status">
|
35
|
-
</a>
|
36
|
-
|
37
|
-
</div>
|
38
|
-
|
39
|
-
|
40
|
-
<div align="center">
|
41
|
-
<a href="https://isathish.github.io/agenticaiframework">
|
42
|
-
<img src="https://img.shields.io/badge/Documentation-Online-blue?logo=readthedocs&logoColor=white" alt="Documentation">
|
43
|
-
</a>
|
44
|
-
|
45
|
-
</div>
|
46
|
-
---
|
47
|
-
# 🌟 AgenticAI Framework
|
48
|
-
|
49
|
-
AgenticAI Framework (`agenticaiframework`) is a **Python SDK** for building **agentic applications** with advanced orchestration, monitoring, multimodal capabilities, and enterprise-grade scalability.
|
50
|
-
It provides a modular, extensible architecture for creating intelligent agents that can interact, reason, and execute tasks across multiple domains.
|
51
|
-
|
52
|
-
---
|
53
|
-
|
54
|
-
## ✨ Key Features
|
55
|
-
|
56
|
-
- **Python-based SDK** for building agentic applications
|
57
|
-
- **Lightweight, high-performance agents** for efficient execution
|
58
|
-
- **Built-in security** mechanisms
|
59
|
-
- **Integrated monitoring and observability**
|
60
|
-
- **Fine-grained configurable parameters**
|
61
|
-
- **Single and multiple agent support**
|
62
|
-
- **Flexible process orchestration** (sequential, parallel, hybrid)
|
63
|
-
- **Extensible architecture** with hubs for agents, prompts, tools, guardrails, and LLMs
|
64
|
-
- **Comprehensive memory management**
|
65
|
-
- **Multiple communication protocols** (HTTP, SSE, STDIO, WebSockets, gRPC, MQ)
|
66
|
-
- **Configurable guardrails, evaluation, and knowledge retrieval**
|
67
|
-
- **Scalable and modular design**
|
68
|
-
- **Multimodal capabilities**: text, images, voice, video
|
69
|
-
- **Cross-platform deployment**: cloud, on-premise, edge
|
70
|
-
- **Extensive integration support**
|
71
|
-
- **Security and compliance ready**
|
72
|
-
|
73
|
-
---
|
74
|
-
|
75
|
-
## 📦 Installation & Setup
|
76
|
-
|
77
|
-
```bash
|
78
|
-
pip install agenticaiframework
|
79
|
-
```
|
80
|
-
|
81
|
-
---
|
82
|
-
|
83
|
-
## ⚡ Quick Start in 3 Steps
|
84
|
-
|
85
|
-
```python
|
86
|
-
from agenticaiframework import Agent, AgentManager
|
87
|
-
|
88
|
-
# Create an agent
|
89
|
-
agent = Agent(
|
90
|
-
name="ExampleAgent",
|
91
|
-
role="assistant",
|
92
|
-
capabilities=["text"],
|
93
|
-
config={"temperature": 0.7}
|
94
|
-
)
|
95
|
-
|
96
|
-
# Manage agents
|
97
|
-
manager = AgentManager()
|
98
|
-
manager.register_agent(agent)
|
99
|
-
|
100
|
-
# Start the agent
|
101
|
-
agent.start()
|
102
|
-
```
|
103
|
-
|
104
|
-
---
|
105
|
-
|
106
|
-
## 📚 Usage Examples & Tutorials
|
107
|
-
|
108
|
-
For more detailed examples, see the [docs/EXAMPLES.md](docs/EXAMPLES.md) file.
|
109
|
-
|
110
|
-
|
111
|
-
### 1. Creating and Running an Agent
|
112
|
-
```python
|
113
|
-
from agenticaiframework import Agent
|
114
|
-
|
115
|
-
agent = Agent(name="HelperBot", role="assistant", capabilities=["text"])
|
116
|
-
agent.start()
|
117
|
-
```
|
118
|
-
|
119
|
-
### 2. Using the Hub to Register and Retrieve Agents
|
120
|
-
```python
|
121
|
-
from agenticaiframework.hub import register_agent, get_agent
|
122
|
-
from agenticaiframework import Agent
|
123
|
-
|
124
|
-
agent = Agent(name="DataBot", role="data_processor", capabilities=["data"])
|
125
|
-
register_agent(agent)
|
126
|
-
|
127
|
-
retrieved_agent = get_agent("DataBot")
|
128
|
-
print(retrieved_agent.name) # Output: DataBot
|
129
|
-
```
|
130
|
-
|
131
|
-
### 3. Memory Management
|
132
|
-
```python
|
133
|
-
from agenticaiframework.memory import Memory
|
134
|
-
|
135
|
-
memory = Memory()
|
136
|
-
memory.store("user_name", "Alice")
|
137
|
-
print(memory.retrieve("user_name")) # Output: Alice
|
138
|
-
```
|
139
|
-
|
140
|
-
### 4. Running Processes
|
141
|
-
```python
|
142
|
-
from agenticaiframework.processes import run_process
|
143
|
-
|
144
|
-
def greet():
|
145
|
-
return "Hello, World!"
|
146
|
-
|
147
|
-
result = run_process(greet)
|
148
|
-
print(result) # Output: Hello, World!
|
149
|
-
```
|
150
|
-
|
151
|
-
---
|
152
|
-
|
153
|
-
## 📖 Extended Documentation & Resources
|
154
|
-
|
155
|
-
The `docs` folder contains in-depth guides and examples:
|
156
|
-
|
157
|
-
- [API Reference](docs/API_REFERENCE.md) — Detailed API documentation for all modules.
|
158
|
-
- [Configuration Guide](docs/CONFIGURATION.md) — How to configure agents, processes, and the framework.
|
159
|
-
- [Usage Guide](docs/USAGE.md) — Step-by-step instructions for common workflows.
|
160
|
-
- [Extending the Framework](docs/EXTENDING.md) — How to add new agents, tools, and capabilities.
|
161
|
-
- [Examples](docs/EXAMPLES.md) — Practical code examples for various use cases.
|
162
|
-
- [Troubleshooting](docs/TROUBLESHOOTING.md) — Common issues and solutions.
|
163
|
-
|
164
|
-
You can also view the online documentation at: [https://isathish.github.io/agenticaiframework/](https://isathish.github.io/agenticaiframework/)
|
165
|
-
|
166
|
-
---
|
167
|
-
|
168
|
-
## 🛠 Configuration Made Easy
|
169
|
-
|
170
|
-
You can configure agents and the framework using:
|
171
|
-
- **Programmatic configuration** via `agenticaiframework.configurations`
|
172
|
-
- **Environment variables**
|
173
|
-
- **Configuration files**
|
174
|
-
|
175
|
-
Example:
|
176
|
-
```python
|
177
|
-
from agenticaiframework.configurations import set_config
|
178
|
-
|
179
|
-
set_config("max_concurrent_tasks", 5)
|
180
|
-
```
|
181
|
-
|
182
|
-
---
|
183
|
-
|
184
|
-
## 🧪 Testing & Quality Assurance
|
185
|
-
|
186
|
-
Run the test suite with:
|
187
|
-
```bash
|
188
|
-
pytest
|
189
|
-
```
|
190
|
-
|
191
|
-
Run with coverage:
|
192
|
-
```bash
|
193
|
-
pytest --cov=agenticaiframework --cov-report=term-missing
|
194
|
-
```
|
195
|
-
|
196
|
-
---
|
197
|
-
|
198
|
-
## 🤝 Contributing
|
199
|
-
|
200
|
-
We welcome contributions from the community!
|
201
|
-
1. Fork the repository.
|
202
|
-
2. Create a feature branch.
|
203
|
-
3. Implement your changes with tests.
|
204
|
-
4. Submit a pull request.
|
205
|
-
|
206
|
-
For more details, see the [Contributing Guidelines](docs/CONTRIBUTING.md) (if available).
|
207
|
-
|
208
|
-
---
|
209
|
-
|
210
|
-
## 📄 License
|
211
|
-
|
212
|
-
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
@@ -1,189 +0,0 @@
|
|
1
|
-
<!-- PROJECT LOGO -->
|
2
|
-
<br />
|
3
|
-
<div align="center">
|
4
|
-
<a href="https://isathish.github.io/agenticaiframework/">
|
5
|
-
<img src="https://img.shields.io/pypi/v/agenticaiframework?color=blue&label=PyPI%20Version&logo=python&logoColor=white" alt="PyPI Version">
|
6
|
-
</a>
|
7
|
-
<a href="https://pypi.org/project/agenticaiframework/">
|
8
|
-
<img src="https://img.shields.io/pypi/dm/agenticaiframework?color=green&label=Downloads&logo=python&logoColor=white" alt="Downloads">
|
9
|
-
</a>
|
10
|
-
<a href="https://github.com/isathish/agenticaiframework/actions">
|
11
|
-
<img src="https://img.shields.io/github/actions/workflow/status/isathish/agenticaiframework/python-package.yml?branch=main&label=Build&logo=github" alt="Build Status">
|
12
|
-
</a>
|
13
|
-
|
14
|
-
</div>
|
15
|
-
|
16
|
-
|
17
|
-
<div align="center">
|
18
|
-
<a href="https://isathish.github.io/agenticaiframework">
|
19
|
-
<img src="https://img.shields.io/badge/Documentation-Online-blue?logo=readthedocs&logoColor=white" alt="Documentation">
|
20
|
-
</a>
|
21
|
-
|
22
|
-
</div>
|
23
|
-
---
|
24
|
-
# 🌟 AgenticAI Framework
|
25
|
-
|
26
|
-
AgenticAI Framework (`agenticaiframework`) is a **Python SDK** for building **agentic applications** with advanced orchestration, monitoring, multimodal capabilities, and enterprise-grade scalability.
|
27
|
-
It provides a modular, extensible architecture for creating intelligent agents that can interact, reason, and execute tasks across multiple domains.
|
28
|
-
|
29
|
-
---
|
30
|
-
|
31
|
-
## ✨ Key Features
|
32
|
-
|
33
|
-
- **Python-based SDK** for building agentic applications
|
34
|
-
- **Lightweight, high-performance agents** for efficient execution
|
35
|
-
- **Built-in security** mechanisms
|
36
|
-
- **Integrated monitoring and observability**
|
37
|
-
- **Fine-grained configurable parameters**
|
38
|
-
- **Single and multiple agent support**
|
39
|
-
- **Flexible process orchestration** (sequential, parallel, hybrid)
|
40
|
-
- **Extensible architecture** with hubs for agents, prompts, tools, guardrails, and LLMs
|
41
|
-
- **Comprehensive memory management**
|
42
|
-
- **Multiple communication protocols** (HTTP, SSE, STDIO, WebSockets, gRPC, MQ)
|
43
|
-
- **Configurable guardrails, evaluation, and knowledge retrieval**
|
44
|
-
- **Scalable and modular design**
|
45
|
-
- **Multimodal capabilities**: text, images, voice, video
|
46
|
-
- **Cross-platform deployment**: cloud, on-premise, edge
|
47
|
-
- **Extensive integration support**
|
48
|
-
- **Security and compliance ready**
|
49
|
-
|
50
|
-
---
|
51
|
-
|
52
|
-
## 📦 Installation & Setup
|
53
|
-
|
54
|
-
```bash
|
55
|
-
pip install agenticaiframework
|
56
|
-
```
|
57
|
-
|
58
|
-
---
|
59
|
-
|
60
|
-
## ⚡ Quick Start in 3 Steps
|
61
|
-
|
62
|
-
```python
|
63
|
-
from agenticaiframework import Agent, AgentManager
|
64
|
-
|
65
|
-
# Create an agent
|
66
|
-
agent = Agent(
|
67
|
-
name="ExampleAgent",
|
68
|
-
role="assistant",
|
69
|
-
capabilities=["text"],
|
70
|
-
config={"temperature": 0.7}
|
71
|
-
)
|
72
|
-
|
73
|
-
# Manage agents
|
74
|
-
manager = AgentManager()
|
75
|
-
manager.register_agent(agent)
|
76
|
-
|
77
|
-
# Start the agent
|
78
|
-
agent.start()
|
79
|
-
```
|
80
|
-
|
81
|
-
---
|
82
|
-
|
83
|
-
## 📚 Usage Examples & Tutorials
|
84
|
-
|
85
|
-
For more detailed examples, see the [docs/EXAMPLES.md](docs/EXAMPLES.md) file.
|
86
|
-
|
87
|
-
|
88
|
-
### 1. Creating and Running an Agent
|
89
|
-
```python
|
90
|
-
from agenticaiframework import Agent
|
91
|
-
|
92
|
-
agent = Agent(name="HelperBot", role="assistant", capabilities=["text"])
|
93
|
-
agent.start()
|
94
|
-
```
|
95
|
-
|
96
|
-
### 2. Using the Hub to Register and Retrieve Agents
|
97
|
-
```python
|
98
|
-
from agenticaiframework.hub import register_agent, get_agent
|
99
|
-
from agenticaiframework import Agent
|
100
|
-
|
101
|
-
agent = Agent(name="DataBot", role="data_processor", capabilities=["data"])
|
102
|
-
register_agent(agent)
|
103
|
-
|
104
|
-
retrieved_agent = get_agent("DataBot")
|
105
|
-
print(retrieved_agent.name) # Output: DataBot
|
106
|
-
```
|
107
|
-
|
108
|
-
### 3. Memory Management
|
109
|
-
```python
|
110
|
-
from agenticaiframework.memory import Memory
|
111
|
-
|
112
|
-
memory = Memory()
|
113
|
-
memory.store("user_name", "Alice")
|
114
|
-
print(memory.retrieve("user_name")) # Output: Alice
|
115
|
-
```
|
116
|
-
|
117
|
-
### 4. Running Processes
|
118
|
-
```python
|
119
|
-
from agenticaiframework.processes import run_process
|
120
|
-
|
121
|
-
def greet():
|
122
|
-
return "Hello, World!"
|
123
|
-
|
124
|
-
result = run_process(greet)
|
125
|
-
print(result) # Output: Hello, World!
|
126
|
-
```
|
127
|
-
|
128
|
-
---
|
129
|
-
|
130
|
-
## 📖 Extended Documentation & Resources
|
131
|
-
|
132
|
-
The `docs` folder contains in-depth guides and examples:
|
133
|
-
|
134
|
-
- [API Reference](docs/API_REFERENCE.md) — Detailed API documentation for all modules.
|
135
|
-
- [Configuration Guide](docs/CONFIGURATION.md) — How to configure agents, processes, and the framework.
|
136
|
-
- [Usage Guide](docs/USAGE.md) — Step-by-step instructions for common workflows.
|
137
|
-
- [Extending the Framework](docs/EXTENDING.md) — How to add new agents, tools, and capabilities.
|
138
|
-
- [Examples](docs/EXAMPLES.md) — Practical code examples for various use cases.
|
139
|
-
- [Troubleshooting](docs/TROUBLESHOOTING.md) — Common issues and solutions.
|
140
|
-
|
141
|
-
You can also view the online documentation at: [https://isathish.github.io/agenticaiframework/](https://isathish.github.io/agenticaiframework/)
|
142
|
-
|
143
|
-
---
|
144
|
-
|
145
|
-
## 🛠 Configuration Made Easy
|
146
|
-
|
147
|
-
You can configure agents and the framework using:
|
148
|
-
- **Programmatic configuration** via `agenticaiframework.configurations`
|
149
|
-
- **Environment variables**
|
150
|
-
- **Configuration files**
|
151
|
-
|
152
|
-
Example:
|
153
|
-
```python
|
154
|
-
from agenticaiframework.configurations import set_config
|
155
|
-
|
156
|
-
set_config("max_concurrent_tasks", 5)
|
157
|
-
```
|
158
|
-
|
159
|
-
---
|
160
|
-
|
161
|
-
## 🧪 Testing & Quality Assurance
|
162
|
-
|
163
|
-
Run the test suite with:
|
164
|
-
```bash
|
165
|
-
pytest
|
166
|
-
```
|
167
|
-
|
168
|
-
Run with coverage:
|
169
|
-
```bash
|
170
|
-
pytest --cov=agenticaiframework --cov-report=term-missing
|
171
|
-
```
|
172
|
-
|
173
|
-
---
|
174
|
-
|
175
|
-
## 🤝 Contributing
|
176
|
-
|
177
|
-
We welcome contributions from the community!
|
178
|
-
1. Fork the repository.
|
179
|
-
2. Create a feature branch.
|
180
|
-
3. Implement your changes with tests.
|
181
|
-
4. Submit a pull request.
|
182
|
-
|
183
|
-
For more details, see the [Contributing Guidelines](docs/CONTRIBUTING.md) (if available).
|
184
|
-
|
185
|
-
---
|
186
|
-
|
187
|
-
## 📄 License
|
188
|
-
|
189
|
-
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
@@ -1,212 +0,0 @@
|
|
1
|
-
Metadata-Version: 2.4
|
2
|
-
Name: agenticaiframework
|
3
|
-
Version: 1.0.24
|
4
|
-
Summary: AgenticAI - A Python SDK for building agentic applications with advanced orchestration, monitoring, and multimodal capabilities.
|
5
|
-
Home-page: https://github.com/isathish/AgenticAI
|
6
|
-
Author: Sathishkumar Nagarajan
|
7
|
-
Author-email: mail@sathishkumarnagarajan.com
|
8
|
-
Classifier: Programming Language :: Python :: 3
|
9
|
-
Classifier: License :: OSI Approved :: MIT License
|
10
|
-
Classifier: Operating System :: OS Independent
|
11
|
-
Requires-Python: >=3.7
|
12
|
-
Description-Content-Type: text/markdown
|
13
|
-
License-File: LICENSE
|
14
|
-
Dynamic: author
|
15
|
-
Dynamic: author-email
|
16
|
-
Dynamic: classifier
|
17
|
-
Dynamic: description
|
18
|
-
Dynamic: description-content-type
|
19
|
-
Dynamic: home-page
|
20
|
-
Dynamic: license-file
|
21
|
-
Dynamic: requires-python
|
22
|
-
Dynamic: summary
|
23
|
-
|
24
|
-
<!-- PROJECT LOGO -->
|
25
|
-
<br />
|
26
|
-
<div align="center">
|
27
|
-
<a href="https://isathish.github.io/agenticaiframework/">
|
28
|
-
<img src="https://img.shields.io/pypi/v/agenticaiframework?color=blue&label=PyPI%20Version&logo=python&logoColor=white" alt="PyPI Version">
|
29
|
-
</a>
|
30
|
-
<a href="https://pypi.org/project/agenticaiframework/">
|
31
|
-
<img src="https://img.shields.io/pypi/dm/agenticaiframework?color=green&label=Downloads&logo=python&logoColor=white" alt="Downloads">
|
32
|
-
</a>
|
33
|
-
<a href="https://github.com/isathish/agenticaiframework/actions">
|
34
|
-
<img src="https://img.shields.io/github/actions/workflow/status/isathish/agenticaiframework/python-package.yml?branch=main&label=Build&logo=github" alt="Build Status">
|
35
|
-
</a>
|
36
|
-
|
37
|
-
</div>
|
38
|
-
|
39
|
-
|
40
|
-
<div align="center">
|
41
|
-
<a href="https://isathish.github.io/agenticaiframework">
|
42
|
-
<img src="https://img.shields.io/badge/Documentation-Online-blue?logo=readthedocs&logoColor=white" alt="Documentation">
|
43
|
-
</a>
|
44
|
-
|
45
|
-
</div>
|
46
|
-
---
|
47
|
-
# 🌟 AgenticAI Framework
|
48
|
-
|
49
|
-
AgenticAI Framework (`agenticaiframework`) is a **Python SDK** for building **agentic applications** with advanced orchestration, monitoring, multimodal capabilities, and enterprise-grade scalability.
|
50
|
-
It provides a modular, extensible architecture for creating intelligent agents that can interact, reason, and execute tasks across multiple domains.
|
51
|
-
|
52
|
-
---
|
53
|
-
|
54
|
-
## ✨ Key Features
|
55
|
-
|
56
|
-
- **Python-based SDK** for building agentic applications
|
57
|
-
- **Lightweight, high-performance agents** for efficient execution
|
58
|
-
- **Built-in security** mechanisms
|
59
|
-
- **Integrated monitoring and observability**
|
60
|
-
- **Fine-grained configurable parameters**
|
61
|
-
- **Single and multiple agent support**
|
62
|
-
- **Flexible process orchestration** (sequential, parallel, hybrid)
|
63
|
-
- **Extensible architecture** with hubs for agents, prompts, tools, guardrails, and LLMs
|
64
|
-
- **Comprehensive memory management**
|
65
|
-
- **Multiple communication protocols** (HTTP, SSE, STDIO, WebSockets, gRPC, MQ)
|
66
|
-
- **Configurable guardrails, evaluation, and knowledge retrieval**
|
67
|
-
- **Scalable and modular design**
|
68
|
-
- **Multimodal capabilities**: text, images, voice, video
|
69
|
-
- **Cross-platform deployment**: cloud, on-premise, edge
|
70
|
-
- **Extensive integration support**
|
71
|
-
- **Security and compliance ready**
|
72
|
-
|
73
|
-
---
|
74
|
-
|
75
|
-
## 📦 Installation & Setup
|
76
|
-
|
77
|
-
```bash
|
78
|
-
pip install agenticaiframework
|
79
|
-
```
|
80
|
-
|
81
|
-
---
|
82
|
-
|
83
|
-
## ⚡ Quick Start in 3 Steps
|
84
|
-
|
85
|
-
```python
|
86
|
-
from agenticaiframework import Agent, AgentManager
|
87
|
-
|
88
|
-
# Create an agent
|
89
|
-
agent = Agent(
|
90
|
-
name="ExampleAgent",
|
91
|
-
role="assistant",
|
92
|
-
capabilities=["text"],
|
93
|
-
config={"temperature": 0.7}
|
94
|
-
)
|
95
|
-
|
96
|
-
# Manage agents
|
97
|
-
manager = AgentManager()
|
98
|
-
manager.register_agent(agent)
|
99
|
-
|
100
|
-
# Start the agent
|
101
|
-
agent.start()
|
102
|
-
```
|
103
|
-
|
104
|
-
---
|
105
|
-
|
106
|
-
## 📚 Usage Examples & Tutorials
|
107
|
-
|
108
|
-
For more detailed examples, see the [docs/EXAMPLES.md](docs/EXAMPLES.md) file.
|
109
|
-
|
110
|
-
|
111
|
-
### 1. Creating and Running an Agent
|
112
|
-
```python
|
113
|
-
from agenticaiframework import Agent
|
114
|
-
|
115
|
-
agent = Agent(name="HelperBot", role="assistant", capabilities=["text"])
|
116
|
-
agent.start()
|
117
|
-
```
|
118
|
-
|
119
|
-
### 2. Using the Hub to Register and Retrieve Agents
|
120
|
-
```python
|
121
|
-
from agenticaiframework.hub import register_agent, get_agent
|
122
|
-
from agenticaiframework import Agent
|
123
|
-
|
124
|
-
agent = Agent(name="DataBot", role="data_processor", capabilities=["data"])
|
125
|
-
register_agent(agent)
|
126
|
-
|
127
|
-
retrieved_agent = get_agent("DataBot")
|
128
|
-
print(retrieved_agent.name) # Output: DataBot
|
129
|
-
```
|
130
|
-
|
131
|
-
### 3. Memory Management
|
132
|
-
```python
|
133
|
-
from agenticaiframework.memory import Memory
|
134
|
-
|
135
|
-
memory = Memory()
|
136
|
-
memory.store("user_name", "Alice")
|
137
|
-
print(memory.retrieve("user_name")) # Output: Alice
|
138
|
-
```
|
139
|
-
|
140
|
-
### 4. Running Processes
|
141
|
-
```python
|
142
|
-
from agenticaiframework.processes import run_process
|
143
|
-
|
144
|
-
def greet():
|
145
|
-
return "Hello, World!"
|
146
|
-
|
147
|
-
result = run_process(greet)
|
148
|
-
print(result) # Output: Hello, World!
|
149
|
-
```
|
150
|
-
|
151
|
-
---
|
152
|
-
|
153
|
-
## 📖 Extended Documentation & Resources
|
154
|
-
|
155
|
-
The `docs` folder contains in-depth guides and examples:
|
156
|
-
|
157
|
-
- [API Reference](docs/API_REFERENCE.md) — Detailed API documentation for all modules.
|
158
|
-
- [Configuration Guide](docs/CONFIGURATION.md) — How to configure agents, processes, and the framework.
|
159
|
-
- [Usage Guide](docs/USAGE.md) — Step-by-step instructions for common workflows.
|
160
|
-
- [Extending the Framework](docs/EXTENDING.md) — How to add new agents, tools, and capabilities.
|
161
|
-
- [Examples](docs/EXAMPLES.md) — Practical code examples for various use cases.
|
162
|
-
- [Troubleshooting](docs/TROUBLESHOOTING.md) — Common issues and solutions.
|
163
|
-
|
164
|
-
You can also view the online documentation at: [https://isathish.github.io/agenticaiframework/](https://isathish.github.io/agenticaiframework/)
|
165
|
-
|
166
|
-
---
|
167
|
-
|
168
|
-
## 🛠 Configuration Made Easy
|
169
|
-
|
170
|
-
You can configure agents and the framework using:
|
171
|
-
- **Programmatic configuration** via `agenticaiframework.configurations`
|
172
|
-
- **Environment variables**
|
173
|
-
- **Configuration files**
|
174
|
-
|
175
|
-
Example:
|
176
|
-
```python
|
177
|
-
from agenticaiframework.configurations import set_config
|
178
|
-
|
179
|
-
set_config("max_concurrent_tasks", 5)
|
180
|
-
```
|
181
|
-
|
182
|
-
---
|
183
|
-
|
184
|
-
## 🧪 Testing & Quality Assurance
|
185
|
-
|
186
|
-
Run the test suite with:
|
187
|
-
```bash
|
188
|
-
pytest
|
189
|
-
```
|
190
|
-
|
191
|
-
Run with coverage:
|
192
|
-
```bash
|
193
|
-
pytest --cov=agenticaiframework --cov-report=term-missing
|
194
|
-
```
|
195
|
-
|
196
|
-
---
|
197
|
-
|
198
|
-
## 🤝 Contributing
|
199
|
-
|
200
|
-
We welcome contributions from the community!
|
201
|
-
1. Fork the repository.
|
202
|
-
2. Create a feature branch.
|
203
|
-
3. Implement your changes with tests.
|
204
|
-
4. Submit a pull request.
|
205
|
-
|
206
|
-
For more details, see the [Contributing Guidelines](docs/CONTRIBUTING.md) (if available).
|
207
|
-
|
208
|
-
---
|
209
|
-
|
210
|
-
## 📄 License
|
211
|
-
|
212
|
-
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
{agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework/configurations.py
RENAMED
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
{agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework.egg-info/SOURCES.txt
RENAMED
File without changes
|
File without changes
|
{agenticaiframework-1.0.24 → agenticaiframework-1.0.26}/agenticaiframework.egg-info/top_level.txt
RENAMED
File without changes
|
File without changes
|