-
Notifications
You must be signed in to change notification settings - Fork 120
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
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -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. | ||||||||||||||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Can we remove the links to Strands-Agent SDK? Given that we're on the docs, I don't think we need them. Let's also have the first link be to the github project - I feel like most developers are going to be judging packages based on GitHub
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Should we link to Deepgram here too? |
||||||||||||||
|
|
||||||||||||||
| ## 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 | ||||||||||||||
|
Comment on lines
+43
to
+45
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||||||||||
| ``` | ||||||||||||||
|
|
||||||||||||||
| 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) | ||||||||||||||
| Original file line number | Diff line number | Diff line change | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| @@ -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 | ||||||||||
|
Comment on lines
+54
to
+55
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||||||
| ``` | ||||||||||
|
|
||||||||||
| Get your API key at: [app.hubspot.com/private-apps](https://app.hubspot.com/private-apps) | ||||||||||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The build is flagging this as not existing and it doesn't resolve for me - Is there a different page that we can link to? |
||||||||||
|
|
||||||||||
| ## 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) | ||||||||||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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) |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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) |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Could we have front-matter content on each of these packages?
Maybe:
I know none of the other pages have this content, but I think going forward it would be beneficial