agentify-core 0.1.0__tar.gz

agentify_core-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Fabian M
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agentify_core-0.1.0/MANIFEST.in

@@ -0,0 +1,8 @@
+include README.md
+include LICENSE
+include requirements.txt
+recursive-include agentify *.py
+recursive-include agentify/extensions *.py
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+recursive-exclude * .DS_Store

agentify_core-0.1.0/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: agentify-core
+Version: 0.1.0
+Summary: Framework-agnostic AI agent library for building single and multi-agent systems
+Author-email: Fabian M <fabian@example.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
+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
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+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
+Provides-Extra: redis
+Requires-Dist: redis>=4.0.0; extra == "redis"
+Provides-Extra: tools
+Requires-Dist: requests>=2.25.0; extra == "tools"
+Provides-Extra: ui
+Requires-Dist: gradio>=3.0.0; extra == "ui"
+Provides-Extra: all
+Requires-Dist: redis>=4.0.0; extra == "all"
+Requires-Dist: requests>=2.25.0; extra == "all"
+Requires-Dist: gradio>=3.0.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+Dynamic: license-file
+
+# Agentify
+
+**Framework-agnostic AI agent library for building single and multi-agent systems**
+
+Agentify is a Python library for building and orchestrating AI agents, from simple assistants to complex multi-agent systems. It focuses on a small set of composable primitives for LLM integration, memory, tools and coordination, so you can focus on product logic instead of framework details.
+
+## Why Agentify?
+
+- **Built for production**: clear abstractions, explicit configuration, error handling and extension points that map well to real deployments.
+- **Orchestration-first design**: a uniform `run()` interface for agents, teams, pipelines and hierarchies makes it straightforward to compose and refactor flows.
+- **Providers**: switch between OpenAI, Gemini, Azure OpenAI, DeepSeek, Claude and others without changing your agent code.
+
+
+## Key Features
+
+- **Agents and multi-agent patterns**  
+  Single Agents with tools and memory, supervisor–worker Multi-Agent Teams, Sequential Pipelines where output flows from step to step, Hierarchical Structures for complex delegation, and Dynamic Flows where a controller decides at runtime which sub-agents or teams to invoke.
+
+- **Memory service and isolation**  
+  Pluggable backends (in-memory, Redis, …) with per-use-case policies (TTL, maximum messages, etc.), plus optional memory isolation so each agent can maintain its own conversation history for scalability and privacy.
+
+- **Tools and actions**  
+  Type-annotated tool interface, straightforward registration of custom tools.
+
+- **Observability hooks**  
+  Callback system for logging, monitoring and debugging agent behaviour across complex flows.
+
+- **I/O capabilities**  
+  Streaming support for real-time responses and vision/image models for multimodal interactions.
+
+
+## Installation
+
+```bash
+pip install agentify
+```
+
+For optional features:
+```bash
+pip install agentify[all]  # Installs all optional dependencies
+```
+
+## Quick Start
+
+```python
+from agentify import BaseAgent, AgentConfig, MemoryService, MemoryAddress
+from agentify.memory.stores import InMemoryStore
+
+# 1. Create memory service
+memory = MemoryService(store=InMemoryStore())
+addr = MemoryAddress(conversation_id="session_1")
+
+# 2. Create an Agent
+agent = BaseAgent(
+    config=AgentConfig(
+        name="Assistant",
+        system_prompt="You are a helpful AI assistant.",
+        provider="openai",
+        model_name="gpt-4.1-mini"
+    ),
+    memory=memory,
+    memory_address=addr
+)
+
+# 3. Run a conversation
+response = agent.respond(user_input="Hello! How can you help me?")
+```
+
+## 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.
+
+
+### 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)
+
+
+## Links
+
+- **Repository**: https://github.com/fa8i/Agentify
+- **Issues**: https://github.com/fa8i/Agentify/issues

agentify_core-0.1.0/README.md

@@ -0,0 +1,101 @@
+# Agentify
+
+**Framework-agnostic AI agent library for building single and multi-agent systems**
+
+Agentify is a Python library for building and orchestrating AI agents, from simple assistants to complex multi-agent systems. It focuses on a small set of composable primitives for LLM integration, memory, tools and coordination, so you can focus on product logic instead of framework details.
+
+## Why Agentify?
+
+- **Built for production**: clear abstractions, explicit configuration, error handling and extension points that map well to real deployments.
+- **Orchestration-first design**: a uniform `run()` interface for agents, teams, pipelines and hierarchies makes it straightforward to compose and refactor flows.
+- **Providers**: switch between OpenAI, Gemini, Azure OpenAI, DeepSeek, Claude and others without changing your agent code.
+
+
+## Key Features
+
+- **Agents and multi-agent patterns**  
+  Single Agents with tools and memory, supervisor–worker Multi-Agent Teams, Sequential Pipelines where output flows from step to step, Hierarchical Structures for complex delegation, and Dynamic Flows where a controller decides at runtime which sub-agents or teams to invoke.
+
+- **Memory service and isolation**  
+  Pluggable backends (in-memory, Redis, …) with per-use-case policies (TTL, maximum messages, etc.), plus optional memory isolation so each agent can maintain its own conversation history for scalability and privacy.
+
+- **Tools and actions**  
+  Type-annotated tool interface, straightforward registration of custom tools.
+
+- **Observability hooks**  
+  Callback system for logging, monitoring and debugging agent behaviour across complex flows.
+
+- **I/O capabilities**  
+  Streaming support for real-time responses and vision/image models for multimodal interactions.
+
+
+## Installation
+
+```bash
+pip install agentify
+```
+
+For optional features:
+```bash
+pip install agentify[all]  # Installs all optional dependencies
+```
+
+## Quick Start
+
+```python
+from agentify import BaseAgent, AgentConfig, MemoryService, MemoryAddress
+from agentify.memory.stores import InMemoryStore
+
+# 1. Create memory service
+memory = MemoryService(store=InMemoryStore())
+addr = MemoryAddress(conversation_id="session_1")
+
+# 2. Create an Agent
+agent = BaseAgent(
+    config=AgentConfig(
+        name="Assistant",
+        system_prompt="You are a helpful AI assistant.",
+        provider="openai",
+        model_name="gpt-4.1-mini"
+    ),
+    memory=memory,
+    memory_address=addr
+)
+
+# 3. Run a conversation
+response = agent.respond(user_input="Hello! How can you help me?")
+```
+
+## 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.
+
+
+### 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)
+
+
+## Links
+
+- **Repository**: https://github.com/fa8i/Agentify
+- **Issues**: https://github.com/fa8i/Agentify/issues

agentify_core-0.1.0/agentify/__init__.py

@@ -0,0 +1,32 @@
+# Core exports
+from agentify.core import (
+    BaseAgent,
+    Tool,
+    AgentConfig,
+    ImageConfig,
+    AgentCallbackHandler,
+    LoggingCallbackHandler,
+)
+
+# LLM exports
+from agentify.llm 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.0"
+
+__all__ = [
+    "BaseAgent",
+    "Tool",
+    "AgentConfig",
+    "ImageConfig",
+    "AgentCallbackHandler",
+    "LoggingCallbackHandler",
+    "LLMClientFactory",
+    "MemoryService",
+    "MemoryAddress",
+    "MemoryPolicy",
+]

agentify_core-0.1.0/agentify/core/__init__.py

@@ -0,0 +1,13 @@
+from agentify.core.agent import BaseAgent
+from agentify.core.tool import Tool
+from agentify.core.callbacks import AgentCallbackHandler, LoggingCallbackHandler
+from agentify.core.config import AgentConfig, ImageConfig
+
+__all__ = [
+    "BaseAgent",
+    "Tool",
+    "AgentCallbackHandler",
+    "LoggingCallbackHandler",
+    "AgentConfig",
+    "ImageConfig",
+]