From c7c2c905ecf382e134adae8613bfd1135d41134d Mon Sep 17 00:00:00 2001 From: eraykeskinmac Date: Thu, 6 Nov 2025 15:19:01 +0300 Subject: [PATCH 1/8] docs: add 5 community tools to docs/community/tools/ Add comprehensive documentation for community-contributed tools: - strands-hubspot: READ-ONLY HubSpot CRM integration with safe data access - strands-teams: Microsoft Teams notifications with Adaptive Cards - strands-telegram: Complete Telegram Bot API with 60+ methods - strands-telegram-listener: Real-time message processing with AI auto-replies - strands-deepgram: Speech & audio processing with 30+ language support Each tool follows the community contribution format with: - Installation instructions - Usage examples - Key features - Configuration requirements - Resource links All tools are production-ready with comprehensive error handling, type safety, and detailed documentation for community adoption. --- docs/community/tools/strands-deepgram.md | 53 ++++++++++++++ docs/community/tools/strands-hubspot.md | 73 +++++++++++++++++++ docs/community/tools/strands-teams.md | 48 ++++++++++++ .../tools/strands-telegram-listener.md | 52 +++++++++++++ docs/community/tools/strands-telegram.md | 49 +++++++++++++ 5 files changed, 275 insertions(+) create mode 100644 docs/community/tools/strands-deepgram.md create mode 100644 docs/community/tools/strands-hubspot.md create mode 100644 docs/community/tools/strands-teams.md create mode 100644 docs/community/tools/strands-telegram-listener.md create mode 100644 docs/community/tools/strands-telegram.md diff --git a/docs/community/tools/strands-deepgram.md b/docs/community/tools/strands-deepgram.md new file mode 100644 index 00000000..c2cedb90 --- /dev/null +++ b/docs/community/tools/strands-deepgram.md @@ -0,0 +1,53 @@ +# strands-deepgram + +{{ community_contribution_banner }} + +[strands-deepgram](https://pypi.org/project/strands-deepgram/) is a production-ready speech and audio processing tool for [Strands Agents SDK](https://github.com/strands-agents/sdk-python), powered by Deepgram's AI platform with 30+ language support. + +## Installation + +```bash +pip install strands-deepgram +``` + +## Usage + +```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") +``` + +## Key Features + +- **Speech-to-Text**: 30+ language support and speaker diarization +- **Text-to-Speech**: Natural-sounding voices (Aura series) +- **Audio Intelligence**: Sentiment analysis, topic detection, and intent recognition +- **Speaker Diarization**: Identify and separate different speakers +- **Multi-format Support**: WAV, MP3, M4A, FLAC, and more +- **Real-time Processing**: Streaming capabilities for live audio + +## Configuration + +```bash +DEEPGRAM_API_KEY=your_deepgram_api_key # Required +DEEPGRAM_DEFAULT_MODEL=nova-3 # Optional +DEEPGRAM_DEFAULT_LANGUAGE=en # Optional +``` + +Get your API key at: [console.deepgram.com](https://console.deepgram.com/) + +## Resources + +- **PyPI**: [pypi.org/project/strands-deepgram](https://pypi.org/project/strands-deepgram/) +- **GitHub**: [github.com/eraykeskinmac/strands-deepgram](https://github.com/eraykeskinmac/strands-deepgram) \ No newline at end of file diff --git a/docs/community/tools/strands-hubspot.md b/docs/community/tools/strands-hubspot.md new file mode 100644 index 00000000..76e3b6b8 --- /dev/null +++ b/docs/community/tools/strands-hubspot.md @@ -0,0 +1,73 @@ +# strands-hubspot + +{{ community_contribution_banner }} + +[strands-hubspot](https://pypi.org/project/strands-hubspot/) is a production-ready HubSpot CRM tool for [Strands Agents SDK](https://github.com/strands-agents/sdk-python), designed for **READ-ONLY** operations with zero risk of data modification. It enables agents to safely access and analyze CRM data without any possibility of corrupting customer information. + +This community tool provides comprehensive HubSpot integration for AI agents, offering safe CRM data access for sales intelligence, customer research, and data analytics workflows. + +## Installation + +```bash +pip install strands-hubspot +pip install 'strands-agents[anthropic]' +``` + +## Usage + +```python +from strands import Agent +from strands_hubspot import hubspot + +# Create an agent with HubSpot READ-ONLY tool +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") + +# Search with filters (READ-ONLY) +agent("search for deals with amount greater than 10000") +``` + +## Key Features + +- **Universal READ-ONLY Access**: Safely search ANY HubSpot object type (contacts, deals, companies, tickets, etc.) +- **Smart Search**: Advanced filtering with property-based queries and sorting +- **Object Retrieval**: Get detailed information for specific CRM objects by ID +- **Property Discovery**: List and explore all available properties for any object type +- **User Management**: Get HubSpot user/owner details and assignments +- **100% Safe**: NO CREATE, UPDATE, or DELETE operations - read-only by design +- **Rich Console Output**: Beautiful table displays with Rich library formatting +- **Type Safe**: Full type hints and comprehensive error handling + +## Configuration + +Set your HubSpot API key as an environment variable: + +```bash +HUBSPOT_API_KEY=your_hubspot_api_key # Required +HUBSPOT_DEFAULT_LIMIT=100 # Optional +``` + +Get your API key at: [app.hubspot.com/private-apps](https://app.hubspot.com/private-apps) + +## Use Cases + +- **Analytics & Reporting**: Generate insights from CRM data +- **Customer Research**: Search and analyze customer information +- **Data Discovery**: Explore available properties and data structure +- **AI-Powered Insights**: Let agents analyze CRM data safely +- **Sales Intelligence**: Extract trends and patterns from deals/contacts +- **Lead Analysis**: Research prospects and opportunities + +## Resources + +- **PyPI**: [pypi.org/project/strands-hubspot](https://pypi.org/project/strands-hubspot/) +- **GitHub**: [github.com/eraykeskinmac/strands-hubspot](https://github.com/eraykeskinmac/strands-hubspot) +- **Examples**: [github.com/eraykeskinmac/strands-tools-examples](https://github.com/eraykeskinmac/strands-tools-examples) \ No newline at end of file diff --git a/docs/community/tools/strands-teams.md b/docs/community/tools/strands-teams.md new file mode 100644 index 00000000..132ee476 --- /dev/null +++ b/docs/community/tools/strands-teams.md @@ -0,0 +1,48 @@ +# strands-teams + +{{ community_contribution_banner }} + +[strands-teams](https://pypi.org/project/strands-teams/) is a production-ready Microsoft Teams notifications tool for [Strands Agents SDK](https://github.com/strands-agents/sdk-python), powered by Adaptive Cards and rich messaging capabilities. + +## Installation + +```bash +pip install strands-teams +``` + +## Usage + +```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") + +# Pre-built templates +agent("send an approval request to Teams for the Q4 budget") + +# Status updates +agent("send status update: website redesign is 75% complete") +``` + +## Key Features + +- **Adaptive Cards**: Rich, interactive message cards with modern UI +- **Pre-built Templates**: Notifications, approvals, status updates, and more +- **Action Buttons**: Interactive elements like approve/reject buttons +- **Rich Formatting**: Markdown support, images, and color coding +- **Type Safe**: Full type hints and validation + +## Configuration + +```bash +TEAMS_WEBHOOK_URL=your_webhook_url # Optional +``` + +## Resources + +- **PyPI**: [pypi.org/project/strands-teams](https://pypi.org/project/strands-teams/) +- **GitHub**: [github.com/eraykeskinmac/strands-teams](https://github.com/eraykeskinmac/strands-teams) \ No newline at end of file diff --git a/docs/community/tools/strands-telegram-listener.md b/docs/community/tools/strands-telegram-listener.md new file mode 100644 index 00000000..2ad043de --- /dev/null +++ b/docs/community/tools/strands-telegram-listener.md @@ -0,0 +1,52 @@ +# strands-telegram-listener + +{{ community_contribution_banner }} + +[strands-telegram-listener](https://pypi.org/project/strands-telegram-listener/) is a production-ready real-time Telegram message processing tool for [Strands Agents SDK](https://github.com/strands-agents/sdk-python) with AI-powered auto-responses and background monitoring. + +## Installation + +```bash +pip install strands-telegram-listener +pip install strands-telegram # Companion package +``` + +## Usage + +```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?") +``` + +## Key Features + +- **Real-time Processing**: Long polling for instant message processing +- **AI Auto-Replies**: Intelligent responses powered by Strands agents +- **Event Storage**: Comprehensive message logging and history (JSONL format) +- **Smart Filtering**: Message deduplication and own message filtering +- **Configurable**: Environment variable control for auto-reply behavior +- **Background Processing**: Non-blocking operation with thread safety + +## Configuration + +```bash +TELEGRAM_BOT_TOKEN=your_bot_token # Required +STRANDS_TELEGRAM_AUTO_REPLY=true # Optional +STRANDS_TELEGRAM_LISTEN_ONLY_TAG="#support" # Optional +``` + +## Resources + +- **PyPI**: [pypi.org/project/strands-telegram-listener](https://pypi.org/project/strands-telegram-listener/) +- **GitHub**: [github.com/eraykeskinmac/strands-telegram-listener](https://github.com/eraykeskinmac/strands-telegram-listener) \ No newline at end of file diff --git a/docs/community/tools/strands-telegram.md b/docs/community/tools/strands-telegram.md new file mode 100644 index 00000000..0009c7d6 --- /dev/null +++ b/docs/community/tools/strands-telegram.md @@ -0,0 +1,49 @@ +# strands-telegram + +{{ community_contribution_banner }} + +[strands-telegram](https://pypi.org/project/strands-telegram/) is a production-ready, comprehensive Telegram Bot API integration for [Strands Agents SDK](https://github.com/strands-agents/sdk-python) with 60+ methods and complete API coverage. + +## Installation + +```bash +pip install strands-telegram +``` + +## Usage + +```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") +``` + +## Key Features + +- **Complete Bot API**: 60+ Telegram API methods (messages, media, keyboards, polls, groups) +- **Interactive Elements**: Inline keyboards, polls, dice games, location sharing +- **Group Management**: Admin tools, user management, permissions control +- **Media Support**: Photos, videos, documents, audio, stickers, voice messages +- **Webhooks**: Full webhook support for real-time message processing +- **Custom API Calls**: Extensible for any Telegram Bot API method + +## Configuration + +```bash +TELEGRAM_BOT_TOKEN=your_bot_token # Required from @BotFather +``` + +## Resources + +- **PyPI**: [pypi.org/project/strands-telegram](https://pypi.org/project/strands-telegram/) +- **GitHub**: [github.com/eraykeskinmac/strands-telegram](https://github.com/eraykeskinmac/strands-telegram) \ No newline at end of file From b54f1fd39567da78cd8dcd16e196b6c13e4eeceb Mon Sep 17 00:00:00 2001 From: eraykeskinmac Date: Thu, 4 Dec 2025 04:58:59 +0300 Subject: [PATCH 2/8] fix: address all PR #320 review feedback - Added YAML frontmatter with project and service information - Changed GitHub links to be primary (instead of PyPI first) - Added service provider links (Deepgram, HubSpot, Teams, Telegram) - Removed Strands SDK links (redundant in docs) - Fixed environment variable alignment with proper comments - Updated HubSpot link to working developer docs URL - Added strands-tools-community meta-package references - Fixed all issues raised by zastrowm in PR review --- docs/community/tools/strands-deepgram.md | 25 +++++++--- docs/community/tools/strands-hubspot.md | 35 +++++++------ docs/community/tools/strands-teams.md | 43 +++++++++++----- .../tools/strands-telegram-listener.md | 50 ++++++++++++------- docs/community/tools/strands-telegram.md | 49 ++++++++++++------ 5 files changed, 134 insertions(+), 68 deletions(-) diff --git a/docs/community/tools/strands-deepgram.md b/docs/community/tools/strands-deepgram.md index c2cedb90..00bca799 100644 --- a/docs/community/tools/strands-deepgram.md +++ b/docs/community/tools/strands-deepgram.md @@ -1,8 +1,20 @@ +--- +project: + pypi: https://pypi.org/project/strands-deepgram/ + github: https://github.com/eraykeskinmac/strands-deepgram + maintainer: eraykeskinmac +service: + name: deepgram + link: https://console.deepgram.com/ +--- + # strands-deepgram {{ community_contribution_banner }} -[strands-deepgram](https://pypi.org/project/strands-deepgram/) is a production-ready speech and audio processing tool for [Strands Agents SDK](https://github.com/strands-agents/sdk-python), powered by Deepgram's AI platform with 30+ language support. +[strands-deepgram](https://github.com/eraykeskinmac/strands-deepgram) is a production-ready speech and audio processing tool powered by [Deepgram's AI platform](https://deepgram.com/) with 30+ language support. + +> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation. ## Installation @@ -40,14 +52,15 @@ agent("analyze sentiment in call.wav") ## Configuration ```bash -DEEPGRAM_API_KEY=your_deepgram_api_key # Required -DEEPGRAM_DEFAULT_MODEL=nova-3 # Optional -DEEPGRAM_DEFAULT_LANGUAGE=en # Optional +DEEPGRAM_API_KEY=your_deepgram_api_key # Required +DEEPGRAM_DEFAULT_MODEL=nova-3 # Optional +DEEPGRAM_DEFAULT_LANGUAGE=en # Optional ``` Get your API key at: [console.deepgram.com](https://console.deepgram.com/) ## Resources -- **PyPI**: [pypi.org/project/strands-deepgram](https://pypi.org/project/strands-deepgram/) -- **GitHub**: [github.com/eraykeskinmac/strands-deepgram](https://github.com/eraykeskinmac/strands-deepgram) \ No newline at end of file +- **PyPI Package**: https://pypi.org/project/strands-deepgram/ +- **GitHub Repository**: https://github.com/eraykeskinmac/strands-deepgram +- **Deepgram API**: https://console.deepgram.com/ \ No newline at end of file diff --git a/docs/community/tools/strands-hubspot.md b/docs/community/tools/strands-hubspot.md index 76e3b6b8..f2434c25 100644 --- a/docs/community/tools/strands-hubspot.md +++ b/docs/community/tools/strands-hubspot.md @@ -1,11 +1,23 @@ +--- +project: + pypi: https://pypi.org/project/strands-hubspot/ + github: https://github.com/eraykeskinmac/strands-hubspot + maintainer: eraykeskinmac +service: + name: hubspot + link: https://developers.hubspot.com/ +--- + # strands-hubspot {{ community_contribution_banner }} -[strands-hubspot](https://pypi.org/project/strands-hubspot/) is a production-ready HubSpot CRM tool for [Strands Agents SDK](https://github.com/strands-agents/sdk-python), designed for **READ-ONLY** operations with zero risk of data modification. It enables agents to safely access and analyze CRM data without any possibility of corrupting customer information. +[strands-hubspot](https://github.com/eraykeskinmac/strands-hubspot) is a production-ready HubSpot CRM tool designed for **READ-ONLY** operations with zero risk of data modification. It enables agents to safely access and analyze CRM data without any possibility of corrupting customer information. This community tool provides comprehensive HubSpot integration for AI agents, offering safe CRM data access for sales intelligence, customer research, and data analytics workflows. +> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation. + ## Installation ```bash @@ -51,23 +63,14 @@ agent("search for deals with amount greater than 10000") Set your HubSpot API key as an environment variable: ```bash -HUBSPOT_API_KEY=your_hubspot_api_key # Required -HUBSPOT_DEFAULT_LIMIT=100 # Optional +HUBSPOT_API_KEY=your_hubspot_api_key # Required +HUBSPOT_DEFAULT_LIMIT=100 # Optional ``` -Get your API key at: [app.hubspot.com/private-apps](https://app.hubspot.com/private-apps) - -## Use Cases - -- **Analytics & Reporting**: Generate insights from CRM data -- **Customer Research**: Search and analyze customer information -- **Data Discovery**: Explore available properties and data structure -- **AI-Powered Insights**: Let agents analyze CRM data safely -- **Sales Intelligence**: Extract trends and patterns from deals/contacts -- **Lead Analysis**: Research prospects and opportunities +Get your API key at: [HubSpot Private Apps](https://developers.hubspot.com/docs/api/private-apps) ## Resources -- **PyPI**: [pypi.org/project/strands-hubspot](https://pypi.org/project/strands-hubspot/) -- **GitHub**: [github.com/eraykeskinmac/strands-hubspot](https://github.com/eraykeskinmac/strands-hubspot) -- **Examples**: [github.com/eraykeskinmac/strands-tools-examples](https://github.com/eraykeskinmac/strands-tools-examples) \ No newline at end of file +- **PyPI Package**: https://pypi.org/project/strands-hubspot/ +- **GitHub Repository**: https://github.com/eraykeskinmac/strands-hubspot +- **HubSpot API Docs**: https://developers.hubspot.com/ \ No newline at end of file diff --git a/docs/community/tools/strands-teams.md b/docs/community/tools/strands-teams.md index 132ee476..3f14b2bf 100644 --- a/docs/community/tools/strands-teams.md +++ b/docs/community/tools/strands-teams.md @@ -1,8 +1,20 @@ +--- +project: + pypi: https://pypi.org/project/strands-teams/ + github: https://github.com/eraykeskinmac/strands-teams + maintainer: eraykeskinmac +service: + name: microsoft-teams + link: https://teams.microsoft.com/ +--- + # strands-teams {{ community_contribution_banner }} -[strands-teams](https://pypi.org/project/strands-teams/) is a production-ready Microsoft Teams notifications tool for [Strands Agents SDK](https://github.com/strands-agents/sdk-python), powered by Adaptive Cards and rich messaging capabilities. +[strands-teams](https://github.com/eraykeskinmac/strands-teams) is a production-ready Microsoft Teams notification tool with rich Adaptive Cards support and custom messaging capabilities. + +> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation. ## Installation @@ -18,31 +30,36 @@ from strands_teams import teams agent = Agent(tools=[teams]) -# Simple notification +# Simple notification agent("send a Teams message: New lead from Acme Corp") -# Pre-built templates -agent("send an approval request to Teams for the Q4 budget") +# Status update with formatting +agent("send a status update: Website redesign is 75% complete") -# Status updates -agent("send status update: website redesign is 75% complete") +# Custom adaptive card +agent("create approval request for Q4 budget with amount $50000") ``` ## Key Features - **Adaptive Cards**: Rich, interactive message cards with modern UI -- **Pre-built Templates**: Notifications, approvals, status updates, and more -- **Action Buttons**: Interactive elements like approve/reject buttons -- **Rich Formatting**: Markdown support, images, and color coding -- **Type Safe**: Full type hints and validation +- **Pre-built Templates**: Notifications, approvals, status updates, and alerts +- **Custom Cards**: Full adaptive card schema support for complex layouts +- **Action Buttons**: Add interactive elements and quick actions +- **Rich Formatting**: Markdown support, images, tables, and media +- **Webhook Integration**: Seamless Teams channel integration ## Configuration ```bash -TEAMS_WEBHOOK_URL=your_webhook_url # Optional +TEAMS_WEBHOOK_URL=your_teams_webhook_url # Optional (can be provided per call) ``` +Setup webhook: Teams Channel → Connectors → Incoming Webhook + ## Resources -- **PyPI**: [pypi.org/project/strands-teams](https://pypi.org/project/strands-teams/) -- **GitHub**: [github.com/eraykeskinmac/strands-teams](https://github.com/eraykeskinmac/strands-teams) \ No newline at end of file +- **PyPI Package**: https://pypi.org/project/strands-teams/ +- **GitHub Repository**: https://github.com/eraykeskinmac/strands-teams +- **Adaptive Cards**: https://adaptivecards.io/ +- **Teams Webhooks**: https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/ \ No newline at end of file diff --git a/docs/community/tools/strands-telegram-listener.md b/docs/community/tools/strands-telegram-listener.md index 2ad043de..cce710a6 100644 --- a/docs/community/tools/strands-telegram-listener.md +++ b/docs/community/tools/strands-telegram-listener.md @@ -1,14 +1,25 @@ +--- +project: + pypi: https://pypi.org/project/strands-telegram-listener/ + github: https://github.com/eraykeskinmac/strands-telegram-listener + maintainer: eraykeskinmac +service: + name: telegram + link: https://core.telegram.org/bots +--- + # strands-telegram-listener {{ community_contribution_banner }} -[strands-telegram-listener](https://pypi.org/project/strands-telegram-listener/) is a production-ready real-time Telegram message processing tool for [Strands Agents SDK](https://github.com/strands-agents/sdk-python) with AI-powered auto-responses and background monitoring. +[strands-telegram-listener](https://github.com/eraykeskinmac/strands-telegram-listener) is a real-time Telegram message processing tool with AI-powered auto-replies and comprehensive event handling. + +> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation. ## Installation ```bash pip install strands-telegram-listener -pip install strands-telegram # Companion package ``` ## Usage @@ -20,33 +31,38 @@ 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") +agent("start Telegram listener") -# Get recent message history -agent("show me the last 10 Telegram messages received") +# Get recent messages +agent("get last 10 Telegram messages") # Check listener status -agent("what's the status of the Telegram listener?") +agent("check Telegram listener status") ``` ## Key Features -- **Real-time Processing**: Long polling for instant message processing -- **AI Auto-Replies**: Intelligent responses powered by Strands agents -- **Event Storage**: Comprehensive message logging and history (JSONL format) -- **Smart Filtering**: Message deduplication and own message filtering -- **Configurable**: Environment variable control for auto-reply behavior -- **Background Processing**: Non-blocking operation with thread safety +- **Real-time Processing**: Long polling for instant message handling +- **AI Auto-replies**: Intelligent responses using Strands agents +- **Event Storage**: Comprehensive message history in JSONL format +- **Smart Filtering**: Message deduplication and selective processing +- **Background Threading**: Non-blocking operation +- **Status Monitoring**: Real-time listener status and metrics +- **Flexible Configuration**: Environment-based settings ## Configuration ```bash -TELEGRAM_BOT_TOKEN=your_bot_token # Required -STRANDS_TELEGRAM_AUTO_REPLY=true # Optional -STRANDS_TELEGRAM_LISTEN_ONLY_TAG="#support" # Optional +TELEGRAM_BOT_TOKEN=your_bot_token # Required +STRANDS_TELEGRAM_AUTO_REPLY=true # Optional +STRANDS_TELEGRAM_LISTEN_ONLY_TAG=#support # Optional ``` +Get your bot token at: [BotFather](https://core.telegram.org/bots#botfather) + ## Resources -- **PyPI**: [pypi.org/project/strands-telegram-listener](https://pypi.org/project/strands-telegram-listener/) -- **GitHub**: [github.com/eraykeskinmac/strands-telegram-listener](https://github.com/eraykeskinmac/strands-telegram-listener) \ No newline at end of file +- **PyPI Package**: https://pypi.org/project/strands-telegram-listener/ +- **GitHub Repository**: https://github.com/eraykeskinmac/strands-telegram-listener +- **Bot Creation Guide**: https://core.telegram.org/bots +- **Telegram Bot API**: https://core.telegram.org/bots/api \ No newline at end of file diff --git a/docs/community/tools/strands-telegram.md b/docs/community/tools/strands-telegram.md index 0009c7d6..c0073d09 100644 --- a/docs/community/tools/strands-telegram.md +++ b/docs/community/tools/strands-telegram.md @@ -1,8 +1,20 @@ +--- +project: + pypi: https://pypi.org/project/strands-telegram/ + github: https://github.com/eraykeskinmac/strands-telegram + maintainer: eraykeskinmac +service: + name: telegram + link: https://core.telegram.org/bots +--- + # strands-telegram {{ community_contribution_banner }} -[strands-telegram](https://pypi.org/project/strands-telegram/) is a production-ready, comprehensive Telegram Bot API integration for [Strands Agents SDK](https://github.com/strands-agents/sdk-python) with 60+ methods and complete API coverage. +[strands-telegram](https://github.com/eraykeskinmac/strands-telegram) is a comprehensive Telegram Bot API integration tool with 60+ methods for complete bot development capabilities. + +> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation. ## Installation @@ -18,32 +30,37 @@ from strands_telegram import telegram agent = Agent(tools=[telegram]) -# Send messages -agent("send a Telegram message to @username: Hello from AI agent!") +# Send simple message +agent("send a Telegram message 'Hello World' to chat 123456") -# Interactive keyboards -agent("send a poll to Telegram: What's your favorite color? Red, Blue, Green") +# Send media with caption +agent("send photo.jpg to Telegram with caption 'Check this out!'") -# Media sharing -agent("send this image to Telegram with caption: image.jpg") +# Create interactive keyboard +agent("send a message with buttons: Yes/No for approval") ``` ## Key Features -- **Complete Bot API**: 60+ Telegram API methods (messages, media, keyboards, polls, groups) -- **Interactive Elements**: Inline keyboards, polls, dice games, location sharing -- **Group Management**: Admin tools, user management, permissions control -- **Media Support**: Photos, videos, documents, audio, stickers, voice messages -- **Webhooks**: Full webhook support for real-time message processing -- **Custom API Calls**: Extensible for any Telegram Bot API method +- **60+ Telegram API Methods**: Complete Bot API coverage +- **Media Support**: Photos, videos, audio, documents, and stickers +- **Interactive Elements**: Inline keyboards, polls, dice games +- **Group Management**: Admin functions, member management, permissions +- **File Operations**: Upload, download, and media handling +- **Webhook Support**: Real-time message processing +- **Custom API Calls**: Extensible for any Telegram method ## Configuration ```bash -TELEGRAM_BOT_TOKEN=your_bot_token # Required from @BotFather +TELEGRAM_BOT_TOKEN=your_bot_token # Required ``` +Get your bot token at: [BotFather](https://core.telegram.org/bots#botfather) + ## Resources -- **PyPI**: [pypi.org/project/strands-telegram](https://pypi.org/project/strands-telegram/) -- **GitHub**: [github.com/eraykeskinmac/strands-telegram](https://github.com/eraykeskinmac/strands-telegram) \ No newline at end of file +- **PyPI Package**: https://pypi.org/project/strands-telegram/ +- **GitHub Repository**: https://github.com/eraykeskinmac/strands-telegram +- **Bot Creation Guide**: https://core.telegram.org/bots +- **Telegram Bot API**: https://core.telegram.org/bots/api \ No newline at end of file From 3dcaa21e42910699e1cbc18dff8cc7796cbd821b Mon Sep 17 00:00:00 2001 From: eraykeskinmac Date: Thu, 4 Dec 2025 05:01:30 +0300 Subject: [PATCH 3/8] fix: remove deprecated strands-tools-community references The strands-tools-community meta-package is deprecated as all tools are now distributed as individual packages on PyPI. Removed the alternative installation references from all tool documentation. --- docs/community/tools/strands-deepgram.md | 2 +- docs/community/tools/strands-hubspot.md | 2 +- docs/community/tools/strands-teams.md | 2 +- docs/community/tools/strands-telegram-listener.md | 2 +- docs/community/tools/strands-telegram.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/community/tools/strands-deepgram.md b/docs/community/tools/strands-deepgram.md index 00bca799..123c91f1 100644 --- a/docs/community/tools/strands-deepgram.md +++ b/docs/community/tools/strands-deepgram.md @@ -14,7 +14,7 @@ service: [strands-deepgram](https://github.com/eraykeskinmac/strands-deepgram) is a production-ready speech and audio processing tool powered by [Deepgram's AI platform](https://deepgram.com/) with 30+ language support. -> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation. + ## Installation diff --git a/docs/community/tools/strands-hubspot.md b/docs/community/tools/strands-hubspot.md index f2434c25..3e00b2ee 100644 --- a/docs/community/tools/strands-hubspot.md +++ b/docs/community/tools/strands-hubspot.md @@ -16,7 +16,7 @@ service: This community tool provides comprehensive HubSpot integration for AI agents, offering safe CRM data access for sales intelligence, customer research, and data analytics workflows. -> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation. + ## Installation diff --git a/docs/community/tools/strands-teams.md b/docs/community/tools/strands-teams.md index 3f14b2bf..9c31410f 100644 --- a/docs/community/tools/strands-teams.md +++ b/docs/community/tools/strands-teams.md @@ -14,7 +14,7 @@ service: [strands-teams](https://github.com/eraykeskinmac/strands-teams) is a production-ready Microsoft Teams notification tool with rich Adaptive Cards support and custom messaging capabilities. -> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation. + ## Installation diff --git a/docs/community/tools/strands-telegram-listener.md b/docs/community/tools/strands-telegram-listener.md index cce710a6..e5e6ec95 100644 --- a/docs/community/tools/strands-telegram-listener.md +++ b/docs/community/tools/strands-telegram-listener.md @@ -14,7 +14,7 @@ service: [strands-telegram-listener](https://github.com/eraykeskinmac/strands-telegram-listener) is a real-time Telegram message processing tool with AI-powered auto-replies and comprehensive event handling. -> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation. + ## Installation diff --git a/docs/community/tools/strands-telegram.md b/docs/community/tools/strands-telegram.md index c0073d09..15c03991 100644 --- a/docs/community/tools/strands-telegram.md +++ b/docs/community/tools/strands-telegram.md @@ -14,7 +14,7 @@ service: [strands-telegram](https://github.com/eraykeskinmac/strands-telegram) is a comprehensive Telegram Bot API integration tool with 60+ methods for complete bot development capabilities. -> **Alternative Installation**: Also available as part of the [strands-tools-community](https://github.com/eraykeskinmac/strands-tools-community) meta-package for convenient multi-tool installation. + ## Installation From 49e014e6422bab18154cdd5bf267eb88ead64ef7 Mon Sep 17 00:00:00 2001 From: eraykeskinmac Date: Thu, 4 Dec 2025 05:08:30 +0300 Subject: [PATCH 4/8] feat: add comprehensive example repository to all community tools Add strands-tools-examples repository link to all tool documentation. This provides users with working examples, complete workflows, and interactive demos for testing all community tools. Repository includes: - Individual tool examples with real-world workflows - Interactive demo agent with REPL interface - Complete setup guide with environment variables - Telegram bot examples with AI-powered auto-replies - End-to-end integration examples combining multiple tools Example repository: https://github.com/eraykeskinmac/strands-tools-examples --- docs/community/tools/strands-deepgram.md | 1 + docs/community/tools/strands-hubspot.md | 1 + docs/community/tools/strands-teams.md | 1 + docs/community/tools/strands-telegram-listener.md | 1 + docs/community/tools/strands-telegram.md | 1 + 5 files changed, 5 insertions(+) diff --git a/docs/community/tools/strands-deepgram.md b/docs/community/tools/strands-deepgram.md index 123c91f1..9834a589 100644 --- a/docs/community/tools/strands-deepgram.md +++ b/docs/community/tools/strands-deepgram.md @@ -63,4 +63,5 @@ Get your API key at: [console.deepgram.com](https://console.deepgram.com/) - **PyPI Package**: https://pypi.org/project/strands-deepgram/ - **GitHub Repository**: https://github.com/eraykeskinmac/strands-deepgram +- **Examples & Demos**: https://github.com/eraykeskinmac/strands-tools-examples - **Deepgram API**: https://console.deepgram.com/ \ No newline at end of file diff --git a/docs/community/tools/strands-hubspot.md b/docs/community/tools/strands-hubspot.md index 3e00b2ee..e0d610f9 100644 --- a/docs/community/tools/strands-hubspot.md +++ b/docs/community/tools/strands-hubspot.md @@ -73,4 +73,5 @@ Get your API key at: [HubSpot Private Apps](https://developers.hubspot.com/docs/ - **PyPI Package**: https://pypi.org/project/strands-hubspot/ - **GitHub Repository**: https://github.com/eraykeskinmac/strands-hubspot +- **Examples & Demos**: https://github.com/eraykeskinmac/strands-tools-examples - **HubSpot API Docs**: https://developers.hubspot.com/ \ No newline at end of file diff --git a/docs/community/tools/strands-teams.md b/docs/community/tools/strands-teams.md index 9c31410f..e1681f44 100644 --- a/docs/community/tools/strands-teams.md +++ b/docs/community/tools/strands-teams.md @@ -61,5 +61,6 @@ Setup webhook: Teams Channel → Connectors → Incoming Webhook - **PyPI Package**: https://pypi.org/project/strands-teams/ - **GitHub Repository**: https://github.com/eraykeskinmac/strands-teams +- **Examples & Demos**: https://github.com/eraykeskinmac/strands-tools-examples - **Adaptive Cards**: https://adaptivecards.io/ - **Teams Webhooks**: https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/ \ No newline at end of file diff --git a/docs/community/tools/strands-telegram-listener.md b/docs/community/tools/strands-telegram-listener.md index e5e6ec95..f04b7d30 100644 --- a/docs/community/tools/strands-telegram-listener.md +++ b/docs/community/tools/strands-telegram-listener.md @@ -64,5 +64,6 @@ Get your bot token at: [BotFather](https://core.telegram.org/bots#botfather) - **PyPI Package**: https://pypi.org/project/strands-telegram-listener/ - **GitHub Repository**: https://github.com/eraykeskinmac/strands-telegram-listener +- **Examples & Demos**: https://github.com/eraykeskinmac/strands-tools-examples - **Bot Creation Guide**: https://core.telegram.org/bots - **Telegram Bot API**: https://core.telegram.org/bots/api \ No newline at end of file diff --git a/docs/community/tools/strands-telegram.md b/docs/community/tools/strands-telegram.md index 15c03991..c8bf47c6 100644 --- a/docs/community/tools/strands-telegram.md +++ b/docs/community/tools/strands-telegram.md @@ -62,5 +62,6 @@ Get your bot token at: [BotFather](https://core.telegram.org/bots#botfather) - **PyPI Package**: https://pypi.org/project/strands-telegram/ - **GitHub Repository**: https://github.com/eraykeskinmac/strands-telegram +- **Examples & Demos**: https://github.com/eraykeskinmac/strands-tools-examples - **Bot Creation Guide**: https://core.telegram.org/bots - **Telegram Bot API**: https://core.telegram.org/bots/api \ No newline at end of file From fa2f31a6e48a76da3c650f5616286212d9f8b986 Mon Sep 17 00:00:00 2001 From: Mackenzie Zastrow Date: Thu, 4 Dec 2025 10:26:33 -0500 Subject: [PATCH 5/8] Update links --- docs/community/tools/strands-deepgram.md | 10 ++++------ docs/community/tools/strands-hubspot.md | 10 ++++------ docs/community/tools/strands-teams.md | 12 +++++------- docs/community/tools/strands-telegram-listener.md | 12 +++++------- docs/community/tools/strands-telegram.md | 12 +++++------- 5 files changed, 23 insertions(+), 33 deletions(-) diff --git a/docs/community/tools/strands-deepgram.md b/docs/community/tools/strands-deepgram.md index 9834a589..efcb250c 100644 --- a/docs/community/tools/strands-deepgram.md +++ b/docs/community/tools/strands-deepgram.md @@ -14,8 +14,6 @@ service: [strands-deepgram](https://github.com/eraykeskinmac/strands-deepgram) is a production-ready speech and audio processing tool powered by [Deepgram's AI platform](https://deepgram.com/) with 30+ language support. - - ## Installation ```bash @@ -61,7 +59,7 @@ Get your API key at: [console.deepgram.com](https://console.deepgram.com/) ## Resources -- **PyPI Package**: https://pypi.org/project/strands-deepgram/ -- **GitHub Repository**: https://github.com/eraykeskinmac/strands-deepgram -- **Examples & Demos**: https://github.com/eraykeskinmac/strands-tools-examples -- **Deepgram API**: https://console.deepgram.com/ \ No newline at end of file +- [PyPI Package](https://pypi.org/project/strands-deepgram/) +- [GitHub Repository](https://github.com/eraykeskinmac/strands-deepgram) +- [Examples & Demos](https://github.com/eraykeskinmac/strands-tools-examples) +- [Deepgram API](https://console.deepgram.com/) diff --git a/docs/community/tools/strands-hubspot.md b/docs/community/tools/strands-hubspot.md index e0d610f9..fef102c5 100644 --- a/docs/community/tools/strands-hubspot.md +++ b/docs/community/tools/strands-hubspot.md @@ -16,8 +16,6 @@ service: This community tool provides comprehensive HubSpot integration for AI agents, offering safe CRM data access for sales intelligence, customer research, and data analytics workflows. - - ## Installation ```bash @@ -71,7 +69,7 @@ Get your API key at: [HubSpot Private Apps](https://developers.hubspot.com/docs/ ## Resources -- **PyPI Package**: https://pypi.org/project/strands-hubspot/ -- **GitHub Repository**: https://github.com/eraykeskinmac/strands-hubspot -- **Examples & Demos**: https://github.com/eraykeskinmac/strands-tools-examples -- **HubSpot API Docs**: https://developers.hubspot.com/ \ No newline at end of file +- [PyPI Package](https://pypi.org/project/strands-hubspot/) +- [GitHub Repository](https://github.com/eraykeskinmac/strands-hubspot) +- [Examples & Demos](https://github.com/eraykeskinmac/strands-tools-examples) +- [HubSpot API Docs](https://developers.hubspot.com/) diff --git a/docs/community/tools/strands-teams.md b/docs/community/tools/strands-teams.md index e1681f44..e15cb128 100644 --- a/docs/community/tools/strands-teams.md +++ b/docs/community/tools/strands-teams.md @@ -14,8 +14,6 @@ service: [strands-teams](https://github.com/eraykeskinmac/strands-teams) is a production-ready Microsoft Teams notification tool with rich Adaptive Cards support and custom messaging capabilities. - - ## Installation ```bash @@ -59,8 +57,8 @@ Setup webhook: Teams Channel → Connectors → Incoming Webhook ## Resources -- **PyPI Package**: https://pypi.org/project/strands-teams/ -- **GitHub Repository**: https://github.com/eraykeskinmac/strands-teams -- **Examples & Demos**: https://github.com/eraykeskinmac/strands-tools-examples -- **Adaptive Cards**: https://adaptivecards.io/ -- **Teams Webhooks**: https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/ \ No newline at end of file +- [PyPI Package](https://pypi.org/project/strands-teams/) +- [GitHub Repository](https://github.com/eraykeskinmac/strands-teams) +- [Examples & Demos](https://github.com/eraykeskinmac/strands-tools-examples) +- [Adaptive Cards](https://adaptivecards.io/) +- [Teams Webhooks](https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/) diff --git a/docs/community/tools/strands-telegram-listener.md b/docs/community/tools/strands-telegram-listener.md index f04b7d30..95cc1d2d 100644 --- a/docs/community/tools/strands-telegram-listener.md +++ b/docs/community/tools/strands-telegram-listener.md @@ -14,8 +14,6 @@ service: [strands-telegram-listener](https://github.com/eraykeskinmac/strands-telegram-listener) is a real-time Telegram message processing tool with AI-powered auto-replies and comprehensive event handling. - - ## Installation ```bash @@ -62,8 +60,8 @@ Get your bot token at: [BotFather](https://core.telegram.org/bots#botfather) ## Resources -- **PyPI Package**: https://pypi.org/project/strands-telegram-listener/ -- **GitHub Repository**: https://github.com/eraykeskinmac/strands-telegram-listener -- **Examples & Demos**: https://github.com/eraykeskinmac/strands-tools-examples -- **Bot Creation Guide**: https://core.telegram.org/bots -- **Telegram Bot API**: https://core.telegram.org/bots/api \ No newline at end of file +- [PyPI Package](https://pypi.org/project/strands-telegram-listener/) +- [GitHub Repository](https://github.com/eraykeskinmac/strands-telegram-listener) +- [Examples & Demos](https://github.com/eraykeskinmac/strands-tools-examples) +- [Bot Creation Guide](https://core.telegram.org/bots) +- [Telegram Bot API](https://core.telegram.org/bots/api) diff --git a/docs/community/tools/strands-telegram.md b/docs/community/tools/strands-telegram.md index c8bf47c6..7eaf9492 100644 --- a/docs/community/tools/strands-telegram.md +++ b/docs/community/tools/strands-telegram.md @@ -14,8 +14,6 @@ service: [strands-telegram](https://github.com/eraykeskinmac/strands-telegram) is a comprehensive Telegram Bot API integration tool with 60+ methods for complete bot development capabilities. - - ## Installation ```bash @@ -60,8 +58,8 @@ Get your bot token at: [BotFather](https://core.telegram.org/bots#botfather) ## Resources -- **PyPI Package**: https://pypi.org/project/strands-telegram/ -- **GitHub Repository**: https://github.com/eraykeskinmac/strands-telegram -- **Examples & Demos**: https://github.com/eraykeskinmac/strands-tools-examples -- **Bot Creation Guide**: https://core.telegram.org/bots -- **Telegram Bot API**: https://core.telegram.org/bots/api \ No newline at end of file +- [PyPI Package](https://pypi.org/project/strands-telegram/) +- [GitHub Repository](https://github.com/eraykeskinmac/strands-telegram) +- [Examples & Demos](https://github.com/eraykeskinmac/strands-tools-examples) +- [Bot Creation Guide](https://core.telegram.org/bots) +- [Telegram Bot API](https://core.telegram.org/bots/api) From c40d2813e5bd7f41a7cdb848d4b6ca2f43caef2d Mon Sep 17 00:00:00 2001 From: Mackenzie Zastrow Date: Thu, 4 Dec 2025 10:26:42 -0500 Subject: [PATCH 6/8] Add tools to nav + reorder sidebar --- mkdocs.yml | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/mkdocs.yml b/mkdocs.yml index feef936c..de5a0ef7 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -209,8 +209,6 @@ nav: - Community: - Community Packages: community/community-packages.md - - Tools: - - UTCP: community/tools/utcp.md - Integrations: - AG-UI: community/integrations/ag-ui.md - Model Providers: @@ -218,7 +216,15 @@ nav: - CLOVA Studio: community/model-providers/clova-studio.md - Fireworks AI: community/model-providers/fireworksai.md - Session Managers: - - Amazon AgentCore Memory: community/session-managers/agentcore-memory.md + - Amazon AgentCore Memory: community/session-managers/agentcore-memory.md + - Tool Protocols: + - UTCP: community/tools/utcp.md + - Tools: + - deepgram: community/tools/strands-deepgram.md + - hubspot: community/tools/strands-hubspot.md + - teams: community/tools/strands-teams.md + - telegram: community/tools/strands-telegram.md + - telegram-listener: community/tools/strands-telegram-listener.md - Contribute ❤️: https://github.com/strands-agents/sdk-python/blob/main/CONTRIBUTING.md - Python API: From 777d8082ef1da4b5d7b772075612f8b9f3e74231 Mon Sep 17 00:00:00 2001 From: Mackenzie Zastrow Date: Thu, 4 Dec 2025 10:30:22 -0500 Subject: [PATCH 7/8] Fix broken link --- docs/community/tools/strands-teams.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community/tools/strands-teams.md b/docs/community/tools/strands-teams.md index e15cb128..c11dd451 100644 --- a/docs/community/tools/strands-teams.md +++ b/docs/community/tools/strands-teams.md @@ -61,4 +61,4 @@ Setup webhook: Teams Channel → Connectors → Incoming Webhook - [GitHub Repository](https://github.com/eraykeskinmac/strands-teams) - [Examples & Demos](https://github.com/eraykeskinmac/strands-tools-examples) - [Adaptive Cards](https://adaptivecards.io/) -- [Teams Webhooks](https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/) +- [Teams Webhooks](https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/what-are-webhooks-and-connectors) From bf8186bb0651620dd4479873c31bd888d37071f2 Mon Sep 17 00:00:00 2001 From: eraykeskinmac Date: Fri, 5 Dec 2025 04:19:25 +0300 Subject: [PATCH 8/8] fix: remove anthropic dependency inconsistency in strands-hubspot - Remove 'strands-agents[anthropic]' from installation as it's inconsistent - Usage example uses default Agent() which works with Bedrock by default - Users can still install anthropic separately if they prefer - Keeps documentation consistent and simple --- docs/community/tools/strands-hubspot.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/community/tools/strands-hubspot.md b/docs/community/tools/strands-hubspot.md index fef102c5..358ca443 100644 --- a/docs/community/tools/strands-hubspot.md +++ b/docs/community/tools/strands-hubspot.md @@ -20,7 +20,6 @@ This community tool provides comprehensive HubSpot integration for AI agents, of ```bash pip install strands-hubspot -pip install 'strands-agents[anthropic]' ``` ## Usage