generated from amazon-archives/__template_Apache-2.0
-
Notifications
You must be signed in to change notification settings - Fork 137
docs: add 5 community tools to docs/community/tools/ #320
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
pgrayy
merged 9 commits into
strands-agents:main
from
eraykeskinmac:add-community-tools-files
Dec 5, 2025
Merged
Changes from all commits
Commits
Show all changes
9 commits
Select commit
Hold shift + click to select a range
c7c2c90
docs: add 5 community tools to docs/community/tools/
eraykeskinmac b54f1fd
fix: address all PR #320 review feedback
eraykeskinmac 3dcaa21
fix: remove deprecated strands-tools-community references
eraykeskinmac 49e014e
feat: add comprehensive example repository to all community tools
eraykeskinmac 9a05c69
Merge remote-tracking branch 'upstream/main' into add-community-tools…
zastrowm fa2f31a
Update links
zastrowm c40d281
Add tools to nav + reorder sidebar
zastrowm 777d808
Fix broken link
zastrowm bf8186b
fix: remove anthropic dependency inconsistency in strands-hubspot
eraykeskinmac File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,65 @@ | ||
| --- | ||
| 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://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 | ||
| 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 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/) | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,74 @@ | ||
| --- | ||
| 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://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. | ||
|
|
||
| ## Installation | ||
|
|
||
| ```bash | ||
| pip install strands-hubspot | ||
| ``` | ||
|
|
||
| ## 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: [HubSpot Private Apps](https://developers.hubspot.com/docs/api/private-apps) | ||
|
|
||
| ## 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/) |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,64 @@ | ||
| --- | ||
| 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://github.com/eraykeskinmac/strands-teams) is a production-ready Microsoft Teams notification tool with rich Adaptive Cards support and custom 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") | ||
|
|
||
| # Status update with formatting | ||
| agent("send a 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 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_teams_webhook_url # Optional (can be provided per call) | ||
| ``` | ||
|
|
||
| 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://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/what-are-webhooks-and-connectors) |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,67 @@ | ||
| --- | ||
| 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://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 | ||
| pip install strands-telegram-listener | ||
| ``` | ||
|
|
||
| ## Usage | ||
|
|
||
| ```python | ||
| from strands import Agent | ||
| from strands_telegram_listener import telegram_listener | ||
|
|
||
| agent = Agent(tools=[telegram_listener]) | ||
|
|
||
| # Start listening for messages | ||
| agent("start Telegram listener") | ||
|
|
||
| # Get recent messages | ||
| agent("get last 10 Telegram messages") | ||
|
|
||
| # Check listener status | ||
| agent("check Telegram listener status") | ||
| ``` | ||
|
|
||
| ## Key Features | ||
|
|
||
| - **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 | ||
| ``` | ||
|
|
||
| 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) |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,65 @@ | ||
| --- | ||
| 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://github.com/eraykeskinmac/strands-telegram) is a comprehensive Telegram Bot API integration tool with 60+ methods for complete bot development capabilities. | ||
|
|
||
| ## Installation | ||
|
|
||
| ```bash | ||
| pip install strands-telegram | ||
| ``` | ||
|
|
||
| ## Usage | ||
|
|
||
| ```python | ||
| from strands import Agent | ||
| from strands_telegram import telegram | ||
|
|
||
| agent = Agent(tools=[telegram]) | ||
|
|
||
| # Send simple message | ||
| agent("send a Telegram message 'Hello World' to chat 123456") | ||
|
|
||
| # Send media with caption | ||
| agent("send photo.jpg to Telegram with caption 'Check this out!'") | ||
|
|
||
| # Create interactive keyboard | ||
| agent("send a message with buttons: Yes/No for approval") | ||
| ``` | ||
|
|
||
| ## Key Features | ||
|
|
||
| - **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 | ||
| ``` | ||
|
|
||
| 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) |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.