diff --git a/docs/community/community-packages.md b/docs/community/community-packages.md index 97b5f557..fa010da9 100644 --- a/docs/community/community-packages.md +++ b/docs/community/community-packages.md @@ -52,6 +52,231 @@ The [strands-agents-tools](https://github.com/strands-agents/tools) repository s - [sleep](https://github.com/strands-agents/tools/blob/main/src/strands_tools/sleep.py) - includes explicit error checking with messages that guide the caller on how to correct errors - [browser](https://github.com/strands-agents/tools/blob/main/src/strands_tools/browser/__init__.py) - detailing how to support multiple tools that share a common core. +### Community Tool Packages + +#### Speech & Audio Processing + +**[strands-deepgram](https://pypi.org/project/strands-deepgram/)** + +A production-ready speech and audio processing tool powered by Deepgram's AI platform. Enables agents to transcribe audio with 30+ language support, generate natural-sounding speech, and perform advanced audio intelligence analysis. + +```bash +pip install strands-deepgram +``` + +Key Features: +- ๐ŸŽค Speech-to-Text with 30+ language support and speaker diarization +- ๐Ÿ—ฃ๏ธ Text-to-Speech with natural-sounding voices (Aura series) +- ๐Ÿง  Audio Intelligence including sentiment analysis, topic detection, and intent recognition +- ๐Ÿ‘ฅ Speaker Diarization to identify and separate different speakers +- ๐ŸŽต Multi-format Support for WAV, MP3, M4A, FLAC, and more +- โšก Real-time Processing with streaming capabilities for live audio + +```python +from strands import Agent +from strands_deepgram import deepgram + +agent = Agent(tools=[deepgram]) + +# Transcribe with speaker identification +agent("transcribe this audio: recording.mp3 with speaker diarization") + +# Text-to-speech +agent("convert this text to speech: Hello world") + +# Audio intelligence +agent("analyze sentiment in call.wav") +``` + +Perfect for call analytics, voice assistants, meeting transcriptions, customer support automation, and any application requiring sophisticated speech processing capabilities. + +### Community Tool Packages + +#### Communication & Messaging + +**[strands-telegram](https://pypi.org/project/strands-telegram/)** + +A production-ready, comprehensive Telegram Bot API integration providing complete access to the Telegram Bot API with 60+ methods. Enables agents to create sophisticated Telegram bots and messaging workflows with full API coverage. + +```bash +pip install strands-telegram +``` + +Key Features: +- ๐Ÿ“จ Complete Bot API with 60+ Telegram API methods (messages, media, keyboards, polls, groups) +- ๐ŸŽฎ Interactive Elements including inline keyboards, polls, dice games, location sharing +- ๐Ÿ‘ฅ Group Management with admin tools, user management, permissions control +- ๐Ÿ“ Media Support for photos, videos, documents, audio, stickers, voice messages +- ๐Ÿ”— Webhooks with full webhook support for real-time message processing +- ๐Ÿ› ๏ธ Custom API Calls extensible for any Telegram Bot API method + +```python +from strands import Agent +from strands_telegram import telegram + +agent = Agent(tools=[telegram]) + +# Send messages +agent("send a Telegram message to @username: Hello from AI agent!") + +# Interactive keyboards +agent("send a poll to Telegram: What's your favorite color? Red, Blue, Green") + +# Media sharing +agent("send this image to Telegram with caption: image.jpg") +``` + +Perfect for global communication (800M+ users), sophisticated user experiences, customer support automation, and comprehensive Telegram bot workflows with full API access. + +**[strands-telegram-listener](https://pypi.org/project/strands-telegram-listener/)** + +A production-ready real-time Telegram message processing tool with AI-powered auto-responses and background message monitoring. Enables agents to listen for incoming Telegram messages and respond intelligently in real-time. + +```bash +pip install strands-telegram-listener +pip install strands-telegram # Companion package +``` + +Key Features: +- ๐ŸŽง Real-time Processing with long polling for instant message processing +- ๐Ÿค– AI Auto-Replies with intelligent responses powered by Strands agents +- ๐Ÿ“Š Event Storage including comprehensive message logging and history (JSONL format) +- ๐Ÿ” Smart Filtering with message deduplication and own message filtering +- โš™๏ธ Configurable through environment variable control for auto-reply behavior +- ๐Ÿงต Background Processing with non-blocking operation and thread safety + +```python +from strands import Agent +from strands_telegram_listener import telegram_listener + +agent = Agent(tools=[telegram_listener]) + +# Start listening for messages +agent("start listening to Telegram messages and respond with AI") + +# Get recent message history +agent("show me the last 10 Telegram messages received") + +# Check listener status +agent("what's the status of the Telegram listener?") +``` + +Perfect for creating interactive chatbots, customer support automation, real-time conversation AI, and complete Telegram ecosystems when paired with strands-telegram. + +### Community Tool Packages + +#### Communication & Messaging + +**[strands-telegram](https://pypi.org/project/strands-telegram/)** + +A production-ready, comprehensive Telegram Bot API integration providing complete access to the Telegram Bot API with 60+ methods. Enables agents to create sophisticated Telegram bots and messaging workflows with full API coverage. + +```bash +pip install strands-telegram +``` + +Key Features: +- ๐Ÿ“จ Complete Bot API with 60+ Telegram API methods (messages, media, keyboards, polls, groups) +- ๐ŸŽฎ Interactive Elements including inline keyboards, polls, dice games, location sharing +- ๐Ÿ‘ฅ Group Management with admin tools, user management, permissions control +- ๐Ÿ“ Media Support for photos, videos, documents, audio, stickers, voice messages +- ๐Ÿ”— Webhooks with full webhook support for real-time message processing +- ๐Ÿ› ๏ธ Custom API Calls extensible for any Telegram Bot API method + +```python +from strands import Agent +from strands_telegram import telegram + +agent = Agent(tools=[telegram]) + +# Send messages +agent("send a Telegram message to @username: Hello from AI agent!") + +# Interactive keyboards +agent("send a poll to Telegram: What's your favorite color? Red, Blue, Green") + +# Media sharing +agent("send this image to Telegram with caption: image.jpg") +``` + +Perfect for global communication (800M+ users), sophisticated user experiences, customer support automation, and comprehensive Telegram bot workflows with full API access. + +### Community Tool Packages + +#### Communication & Notifications + +**[strands-teams](https://pypi.org/project/strands-teams/)** + +A production-ready Microsoft Teams notifications tool powered by Adaptive Cards and rich messaging capabilities. Enables agents to send beautiful, interactive notifications to Teams channels with professional UI elements. + +```bash +pip install strands-teams +``` + +Key Features: +- ๐ŸŽจ Adaptive Cards with rich, interactive message cards and modern UI +- ๐Ÿ“‹ Pre-built templates for notifications, approvals, status updates, and more +- โšก Custom Cards with full adaptive card schema support for unlimited flexibility +- ๐Ÿ”˜ Action Buttons for interactive elements like approve/reject functionality +- ๐ŸŽฏ Rich Formatting with Markdown support, images, media, and color coding +- ๐Ÿ› ๏ธ Easy Integration as a drop-in tool for Strands agents + +```python +from strands import Agent +from strands_teams import teams + +agent = Agent(tools=[teams]) + +# Simple notification +agent("send a Teams message: New lead from Acme Corp") + +# Use pre-built templates +agent("send an approval request to Teams for the Q4 budget") + +# Status updates with rich formatting +agent("send a status update to Teams: website redesign is 75% complete") +``` + +Perfect for enterprise communication, team collaboration, workflow notifications, approval processes, and professional team messaging for AI agents. + +### Community Tool Packages + +#### CRM & Customer Data + +**[strands-hubspot](https://pypi.org/project/strands-hubspot/)** + +A production-ready HubSpot CRM tool designed for **READ-ONLY** operations with zero risk of data modification. Enables agents to safely access and analyze CRM data without any possibility of corrupting customer information. + +```bash +pip install strands-hubspot +``` + +Key Features: +- ๐Ÿ” Universal READ-ONLY access to all HubSpot object types (contacts, deals, companies, tickets) +- ๐Ÿ”Ž Smart search with advanced filtering and property-based queries +- ๐Ÿ“„ Detailed object retrieval by ID with customizable property selection +- ๐Ÿท๏ธ Property discovery and metadata exploration for any object type +- ๐Ÿ‘ค User management and owner details retrieval +- ๐Ÿ›ก๏ธ 100% safe design with NO CREATE, UPDATE, or DELETE operations + +```python +from strands import Agent +from strands_hubspot import hubspot + +agent = Agent(tools=[hubspot]) + +# Search contacts (READ-ONLY) +agent("find all contacts created in the last 30 days") + +# Get company details (READ-ONLY) +agent("get company information for ID 67890") + +# List available properties (READ-ONLY) +agent("show me all available deal properties") +``` + +Perfect for sales intelligence, customer research, data analytics, and CRM workflows that require safe data access without modification risks. + ## Support & Resources Building community packages extends the Strands Agents ecosystem and helps other developers solve complex problems with AI agents. Your contributions make the entire community more capable and productive.