agentify-core 0.1.4__tar.gz → 0.3.0__tar.gz

{agentify_core-0.1.4/agentify_core.egg-info → agentify_core-0.3.0}/PKG-INFO

@@ -1,19 +1,18 @@
 Metadata-Version: 2.4
 Name: agentify-core
-Version: 0.1.4
+Version: 0.3.0
 Summary: Framework-agnostic AI agent library for building single and multi-agent systems
-Author-email: Fabian M <fabian@example.com>
+Author-email: Fabian M <fabianmp_98@hotmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/fa8i/Agentify
 Project-URL: Repository, https://github.com/fa8i/Agentify
 Project-URL: Bug Tracker, https://github.com/fa8i/Agentify/issues
-Keywords: agent,multi-agent,ai,llm,openai,framework
+Keywords: agentify,agentify-core,agent,multi-agent,ai,llm,openai,framework
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 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
@@ -22,19 +21,25 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: openai>=1.0.0
-Requires-Dist: python-dotenv>=0.19.0
-Requires-Dist: Pillow>=9.0.0
+Requires-Dist: openai
+Requires-Dist: python-dotenv
+Requires-Dist: Pillow
 Provides-Extra: redis
 Requires-Dist: redis>=4.0.0; extra == "redis"
+Provides-Extra: elastic
+Requires-Dist: elasticsearch>=8.0.0; extra == "elastic"
 Provides-Extra: tools
 Requires-Dist: requests>=2.25.0; extra == "tools"
+Provides-Extra: mcp
+Requires-Dist: mcp; extra == "mcp"
 Provides-Extra: ui
 Requires-Dist: gradio==5.49.1; extra == "ui"
 Provides-Extra: all
 Requires-Dist: redis>=4.0.0; extra == "all"
+Requires-Dist: elasticsearch>=8.0.0; extra == "all"
 Requires-Dist: requests>=2.25.0; extra == "all"
 Requires-Dist: gradio==5.49.1; extra == "all"
+Requires-Dist: mcp; extra == "all"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
@@ -47,6 +52,7 @@ Dynamic: license-file
 
 # Agentify
 
+
 **Independent AI agent library based on the OpenAI SDK**
 
 Agentify is a Python library for building and orchestrating AI agents, from simple assistants to complex multi-agent systems. It targets the OpenAI-compatible Chat Completions interface, enabling support for multiple providers through a configurable `base_url` (OpenAI, Azure OpenAI, DeepSeek, Gemini, etc.). Agentify offers a streamlined, independent set of primitives for memory, tools, and coordination so you can focus on product logic without being tied to heavy frameworks.
@@ -72,7 +78,7 @@ Agentify is a Python library for building and orchestrating AI agents, from simp
   "Chain of Thought" in conversation history, and log reasoning steps in real-time for visibility.
 
 - **Tools and actions**  
-  Type-annotated tool interface, straightforward registration of custom tools.
+  Simple `@tool` decorator for creating tools from functions with automatic JSON Schema generation, or type-annotated tool interface for custom implementations.
 
 - **Observability hooks**  
   Callback system for logging, monitoring and debugging agent behaviour across complex flows.
@@ -80,6 +86,9 @@ Agentify is a Python library for building and orchestrating AI agents, from simp
 - **I/O capabilities**  
   Streaming support for real-time responses and vision/image models for multimodal interactions.
 
+- **Async & Parallel Execution**  
+  Built-in `async/await` support (`arun()`) for all agents and flows. Automatically executes independent tool calls in parallel (e.g., fetching data from 3 APIs simultaneously), significantly reducing latency.
+
 
 ## Installation
 
@@ -95,29 +104,37 @@ pip install agentify-core[all]  # Installs all optional dependencies
 ## Quick Start
 
 ```python
-from agentify import BaseAgent, AgentConfig, MemoryService, MemoryAddress
+from agentify import BaseAgent, AgentConfig, MemoryService, MemoryAddress, tool
 from agentify.memory.stores import InMemoryStore
 
-# 1. Create memory service
+# 1. Create a simple tool with @tool decorator
+@tool
+def get_time() -> dict:
+    """Returns the current time."""
+    from datetime import datetime
+    return {"time": datetime.now().strftime("%H:%M:%S")}
+
+# 2. Create memory service
 memory = MemoryService(store=InMemoryStore(), log_enabled=True, max_log_length=100)
 addr = MemoryAddress(conversation_id="session_1")
 
-# 2. Create an Agent
+# 3. Create an Agent with the tool
 agent = BaseAgent(
     config=AgentConfig(
         name="ReasoningAgent",
         system_prompt="You are a helpful assistant.",
-        provider="openai",
-        model_name="gpt-5",
+        provider="provider",
+        model_name="model",
         reasoning_effort="high",  # optional param:"low", "medium", "high"
         model_kwargs={"max_completion_tokens": 5000} # Pass model-specific params
     ),
     memory=memory,
-    memory_address=addr
+    memory_address=addr,
+    tools=[get_time]  # Add your tools here
 )
 
-# 3. Run a conversation
-response = agent.run(user_input="Hello! How can you help me?")
+# 4. Run a conversation
+response = agent.run(user_input="What time is it?")
 ```
 
 ## Composable Flows

agentify_core-0.3.0/README.md

@@ -0,0 +1,108 @@
+# Agentify
+
+[![PyPI version](https://img.shields.io/pypi/v/agentify-core?color=orange)](https://pypi.org/project/agentify-core/)
+[![Downloads](https://img.shields.io/pepy/dt/agentify-core)](https://pepy.tech/project/agentify-core)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/agentify-core)](https://pypi.org/project/agentify-core/)
+
+**Independent AI agent library based on the OpenAI SDK**
+
+Agentify is a Python library for building AI agents and multi-agent systems. Built on the OpenAI-compatible Chat Completions interface, it supports multiple providers (OpenAI, Azure, DeepSeek, Gemini, Claude) with clear abstractions for memory, tools, and orchestration—no heavy framework lock-in.
+
+
+## Key Features
+
+- **Multi-agent orchestration**: Teams, pipelines, hierarchies, and dynamic sub-agent spawning
+- **Memory service**: Pluggable backends (in-memory, SQLite, Redis, Elasticsearch) with policies (TTL, limits, token budgets)
+- **Tools**: `@tool` decorator for auto-schema generation, or custom tool classes. Built-in file I/O, planning, weather, and more
+- **MCP Integration**: Easy connection to MCP servers via StdIO (local) or SSE/HTTP (remote) to use external tools
+- **Reasoning models**: Configure thinking depth, store chain-of-thought, real-time reasoning logs
+- **Async & parallel**: `arun()` support with automatic parallel tool and agent execution
+- **Observability**: Callback system for monitoring and debugging
+- **Advanced capabilities**: Dynamic workflows, file/directory operations, complex state management
+
+
+## Installation
+
+```bash
+pip install agentify-core
+```
+
+For optional features:
+```bash
+pip install agentify-core[all]  # Installs all optional dependencies
+```
+
+## Quick Start
+
+```python
+from agentify import BaseAgent, AgentConfig, MemoryService, MemoryAddress, tool
+from agentify.memory.stores import InMemoryStore
+
+# 1. Create a simple tool with @tool decorator
+@tool
+def get_time() -> dict:
+    """Returns the current time."""
+    from datetime import datetime
+    return {"time": datetime.now().strftime("%H:%M:%S")}
+
+# 2. Create memory service
+memory = MemoryService(store=InMemoryStore(), log_enabled=True, max_log_length=100)
+addr = MemoryAddress(conversation_id="session_1")
+
+# 3. Create an Agent with the tool
+agent = BaseAgent(
+    config=AgentConfig(
+        name="ReasoningAgent",
+        system_prompt="You are a helpful assistant.",
+        provider="provider",
+        model_name="model",
+        reasoning_effort="high",  # optional param:"low", "medium", "high"
+        model_kwargs={"max_completion_tokens": 5000} # Pass model-specific params
+    ),
+    memory=memory,
+    memory_address=addr,
+    tools=[get_time]  # Add your tools here
+)
+
+# 4. Run a conversation
+response = agent.run(user_input="What time is it?")
+```
+
+## Composable Flows
+
+Agentify provides powerful primitives that can be combined to build arbitrarily complex systems:
+
+* **BaseAgent**: The fundamental unit of work.
+* **Teams**: A group of agents managed by a supervisor.
+* **Pipelines**: A sequence of steps where output passes from one to the next.
+* **Hierarchies**: Tree structures for massive delegation.
+
+Because all flows share the same `run()` interface, you can build Teams made of Pipelines, Pipelines made of Teams, and deeply nested Hierarchies.
+
+Agentify supports both **strict workflows** (fixed, pre-defined Pipelines and Hierarchies) and **dynamic agentic flows**, where a supervisor/router agent decides at runtime which agent, Team or Pipeline to call next.
+
+
+## Documentation
+
+- [Getting Started](docs/getting_started.md) - Installation and first steps
+- [Core Concepts](docs/core_concepts.md) - Agents, memory, and tools
+- [Multi-Agent Systems](docs/multi_agent.md) - Teams, pipelines, and hierarchies
+- [Advanced Features](docs/advanced.md) - Vision, streaming, hooks, and more
+- [API Reference](docs/api_reference.md) - Complete API documentation
+
+
+### More Examples
+
+Check out the [examples](examples/) directory for detailed implementations:
+
+*   [Single Agent Chatbot](examples/chatbot/)
+*   [Multi-Agent Teams](examples/multi_agent/team/)
+*   [Sequential Pipelines](examples/multi_agent/pipeline/)
+*   [Hierarchical Structures](examples/multi_agent/hierarchical/)
+
+
+## Author
+
+- **Fabian Melchor** [fabianmp_98@hotmail.com](mailto:fabianmp_98@hotmail.com)
+

{agentify_core-0.1.4 → agentify_core-0.3.0}/README_PYPI.md

@@ -1,5 +1,6 @@
 # Agentify
 
+
 **Independent AI agent library based on the OpenAI SDK**
 
 Agentify is a Python library for building and orchestrating AI agents, from simple assistants to complex multi-agent systems. It targets the OpenAI-compatible Chat Completions interface, enabling support for multiple providers through a configurable `base_url` (OpenAI, Azure OpenAI, DeepSeek, Gemini, etc.). Agentify offers a streamlined, independent set of primitives for memory, tools, and coordination so you can focus on product logic without being tied to heavy frameworks.
@@ -25,7 +26,7 @@ Agentify is a Python library for building and orchestrating AI agents, from simp
   "Chain of Thought" in conversation history, and log reasoning steps in real-time for visibility.
 
 - **Tools and actions**  
-  Type-annotated tool interface, straightforward registration of custom tools.
+  Simple `@tool` decorator for creating tools from functions with automatic JSON Schema generation, or type-annotated tool interface for custom implementations.
 
 - **Observability hooks**  
   Callback system for logging, monitoring and debugging agent behaviour across complex flows.
@@ -33,6 +34,9 @@ Agentify is a Python library for building and orchestrating AI agents, from simp
 - **I/O capabilities**  
   Streaming support for real-time responses and vision/image models for multimodal interactions.
 
+- **Async & Parallel Execution**  
+  Built-in `async/await` support (`arun()`) for all agents and flows. Automatically executes independent tool calls in parallel (e.g., fetching data from 3 APIs simultaneously), significantly reducing latency.
+
 
 ## Installation
 
@@ -48,29 +52,37 @@ pip install agentify-core[all]  # Installs all optional dependencies
 ## Quick Start
 
 ```python
-from agentify import BaseAgent, AgentConfig, MemoryService, MemoryAddress
+from agentify import BaseAgent, AgentConfig, MemoryService, MemoryAddress, tool
 from agentify.memory.stores import InMemoryStore
 
-# 1. Create memory service
+# 1. Create a simple tool with @tool decorator
+@tool
+def get_time() -> dict:
+    """Returns the current time."""
+    from datetime import datetime
+    return {"time": datetime.now().strftime("%H:%M:%S")}
+
+# 2. Create memory service
 memory = MemoryService(store=InMemoryStore(), log_enabled=True, max_log_length=100)
 addr = MemoryAddress(conversation_id="session_1")
 
-# 2. Create an Agent
+# 3. Create an Agent with the tool
 agent = BaseAgent(
     config=AgentConfig(
         name="ReasoningAgent",
         system_prompt="You are a helpful assistant.",
-        provider="openai",
-        model_name="gpt-5",
+        provider="provider",
+        model_name="model",
         reasoning_effort="high",  # optional param:"low", "medium", "high"
         model_kwargs={"max_completion_tokens": 5000} # Pass model-specific params
     ),
     memory=memory,
-    memory_address=addr
+    memory_address=addr,
+    tools=[get_time]  # Add your tools here
 )
 
-# 3. Run a conversation
-response = agent.run(user_input="Hello! How can you help me?")
+# 4. Run a conversation
+response = agent.run(user_input="What time is it?")
 ```
 
 ## Composable Flows
@@ -101,4 +113,4 @@ MIT License - see the repository for details.
 
 ## Author
 
-**Fabian Melchor** - [fabianmp_98@hotmail.com](mailto:fabianmp_98@hotmail.com)
+**Fabian Melchor** - [fabianmp_98@hotmail.com](mailto:fabianmp_98@hotmail.com)

{agentify_core-0.1.4 → agentify_core-0.3.0}/agentify/__init__.py

@@ -1,32 +1,26 @@
 # Core exports
-from agentify.core import (
-    BaseAgent,
-    Tool,
-    AgentConfig,
-    ImageConfig,
-    AgentCallbackHandler,
-    LoggingCallbackHandler,
-)
+from agentify.core.agent import BaseAgent
+from agentify.core.config import AgentConfig, ImageConfig
+from agentify.core.tool import Tool, tool
 
 # LLM exports
-from agentify.llm import LLMClientFactory
+from agentify.llm.client import LLMClientFactory
 
 # Memory exports
 from agentify.memory.service import MemoryService
 from agentify.memory.interfaces import MemoryAddress
 from agentify.memory.policies import MemoryPolicy
 
-__version__ = "0.1.3"
+__version__ = "0.3.0"
 
 __all__ = [
     "BaseAgent",
-    "Tool",
     "AgentConfig",
-    "ImageConfig",
-    "AgentCallbackHandler",
-    "LoggingCallbackHandler",
+    "Tool",
+    "tool",
     "LLMClientFactory",
     "MemoryService",
     "MemoryAddress",
     "MemoryPolicy",
+    "ImageConfig",
 ]

{agentify_core-0.1.4 → agentify_core-0.3.0}/agentify/core/__init__.py

@@ -1,11 +1,14 @@
+"""Core components for building AI agents."""
+
 from agentify.core.agent import BaseAgent
-from agentify.core.tool import Tool
+from agentify.core.tool import Tool, tool
 from agentify.core.callbacks import AgentCallbackHandler, LoggingCallbackHandler
 from agentify.core.config import AgentConfig, ImageConfig
 
 __all__ = [
     "BaseAgent",
     "Tool",
+    "tool",
     "AgentCallbackHandler",
     "LoggingCallbackHandler",
     "AgentConfig",