Metadata-Version: 2.4
Name: agentic-notify
Version: 0.1.0
Summary: A Python library for building agentic, notification-driven workflows with pluggable adapters, policy-aware handlers, and scalable integration interfaces.
License-File: LICENSE
Author: Your Name
Author-email: you@example.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.14
Provides-Extra: fastapi
Provides-Extra: mcp
Provides-Extra: observability
Provides-Extra: redis
Requires-Dist: pydantic (>=2.0.0,<3.0.0)
Description-Content-Type: text/markdown

# agentic-notify

A Python library for building **agentic, notification-driven workflows** with pluggable adapters, policy-aware handlers, and scalable integration interfaces for cross-native applications.

## Overview

`agentic-notify` gives you a **backend-first orchestration SDK** with clear extension points:

- **Ingestion & Normalization:** Accept notifications from Android/React Native bridges and convert them to a canonical schema.
- **Agentic Routing:** Send notifications to workflows based on LLM decisions or rules.
- **Workflow Orchestration:** Execute steps safely, handle retries, and check execution policies.
- **Adapters:** Connect your workflow engine to device boundaries (Reminders, Summaries, Local DBs).

## Architecture Approach

- **Schemas define contracts** (via Pydantic)
- **Normalizers unify platforms**
- **Routers decide**
- **Workflows orchestrate**
- **Handlers transform**
- **Adapters act**
- **Integrations connect**
- **Policies constrain**

## Installation

```bash
# Core package
pip install agentic-notify

# Install with FastAPI and Redis support
pip install agentic-notify[fastapi,redis]
```

