Metadata-Version: 2.4
Name: novu-agents
Version: 0.1.0a1
Summary: Novu agents for Python: run your own agent on Slack, Teams, WhatsApp, email and web chat through Novu (preview).
Project-URL: Homepage, https://novu.co
Project-URL: Documentation, https://docs.novu.co
Author-email: Novu <support@novu.co>
License: MIT
Keywords: agents,chat,google-adk,novu,slack
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: AsyncIO
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27
Requires-Dist: starlette>=0.40
Provides-Extra: adk
Requires-Dist: google-adk<3,>=2.14; extra == 'adk'
Description-Content-Type: text/markdown

# novu-agents

> **Alpha preview.** The API may change between releases.

Run your own Python agent on Slack, Teams, WhatsApp, email and web chat through [Novu](https://novu.co).
Includes an adapter for [Google ADK](https://google.github.io/adk-docs/).

```bash
pip install --pre "novu-agents[adk]"
```

```python
from fastapi import FastAPI
from novu_agents import mount
from novu_agents.adk import AdkAgent, run

api = FastAPI()

class Concierge(AdkAgent):
    id = "my-agent"                      # the agent identifier in Novu

    async def on_message(self, message, ctx):
        return run(adk_app, ctx)         # your google.adk.apps.App

mount(api, "/api/novu", agents=[Concierge()], create_agents=True)
```

Set `NOVU_SECRET_KEY` (and `NOVU_API_URL` for the EU region), then point the agent's bridge URL at `/api/novu`.
ADK tool confirmations become Approve / Deny cards, sub-agents show a "working…" status, and replies stream live
on Slack and web chat.
