Skip to content

Commit c7c2c90

Browse files
eraykeskinmaceraykeskinmac
committed
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.
1 parent a79b0e6 commit c7c2c90

File tree

5 files changed

+275
-0
lines changed

5 files changed

+275
-0
lines changed

‎docs/community/tools/strands-deepgram.md‎

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
# strands-deepgram
2+
3+
{{ community_contribution_banner }}
4+
5+
[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.
6+
7+
## Installation
8+
9+
```bash
10+
pip install strands-deepgram
11+
```
12+
13+
## Usage
14+
15+
```python
16+
from strands import Agent
17+
from strands_deepgram import deepgram
18+
19+
agent = Agent(tools=[deepgram])
20+
21+
# Transcribe with speaker identification
22+
agent("transcribe this audio: recording.mp3 with speaker diarization")
23+
24+
# Text-to-speech
25+
agent("convert this text to speech: Hello world")
26+
27+
# Audio intelligence
28+
agent("analyze sentiment in call.wav")
29+
```
30+
31+
## Key Features
32+
33+
- **Speech-to-Text**: 30+ language support and speaker diarization
34+
- **Text-to-Speech**: Natural-sounding voices (Aura series)
35+
- **Audio Intelligence**: Sentiment analysis, topic detection, and intent recognition
36+
- **Speaker Diarization**: Identify and separate different speakers
37+
- **Multi-format Support**: WAV, MP3, M4A, FLAC, and more
38+
- **Real-time Processing**: Streaming capabilities for live audio
39+
40+
## Configuration
41+
42+
```bash
43+
DEEPGRAM_API_KEY=your_deepgram_api_key # Required
44+
DEEPGRAM_DEFAULT_MODEL=nova-3 # Optional
45+
DEEPGRAM_DEFAULT_LANGUAGE=en # Optional
46+
```
47+
48+
Get your API key at: [console.deepgram.com](https://console.deepgram.com/)
49+
50+
## Resources
51+
52+
- **PyPI**: [pypi.org/project/strands-deepgram](https://pypi.org/project/strands-deepgram/)
53+
- **GitHub**: [github.com/eraykeskinmac/strands-deepgram](https://github.com/eraykeskinmac/strands-deepgram)

‎docs/community/tools/strands-hubspot.md‎

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
# strands-hubspot
2+
3+
{{ community_contribution_banner }}
4+
5+
[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.
6+
7+
This community tool provides comprehensive HubSpot integration for AI agents, offering safe CRM data access for sales intelligence, customer research, and data analytics workflows.
8+
9+
## Installation
10+
11+
```bash
12+
pip install strands-hubspot
13+
pip install 'strands-agents[anthropic]'
14+
```
15+
16+
## Usage
17+
18+
```python
19+
from strands import Agent
20+
from strands_hubspot import hubspot
21+
22+
# Create an agent with HubSpot READ-ONLY tool
23+
agent = Agent(tools=[hubspot])
24+
25+
# Search contacts (READ-ONLY)
26+
agent("find all contacts created in the last 30 days")
27+
28+
# Get company details (READ-ONLY)
29+
agent("get company information for ID 67890")
30+
31+
# List available properties (READ-ONLY)
32+
agent("show me all available deal properties")
33+
34+
# Search with filters (READ-ONLY)
35+
agent("search for deals with amount greater than 10000")
36+
```
37+
38+
## Key Features
39+
40+
- **Universal READ-ONLY Access**: Safely search ANY HubSpot object type (contacts, deals, companies, tickets, etc.)
41+
- **Smart Search**: Advanced filtering with property-based queries and sorting
42+
- **Object Retrieval**: Get detailed information for specific CRM objects by ID
43+
- **Property Discovery**: List and explore all available properties for any object type
44+
- **User Management**: Get HubSpot user/owner details and assignments
45+
- **100% Safe**: NO CREATE, UPDATE, or DELETE operations - read-only by design
46+
- **Rich Console Output**: Beautiful table displays with Rich library formatting
47+
- **Type Safe**: Full type hints and comprehensive error handling
48+
49+
## Configuration
50+
51+
Set your HubSpot API key as an environment variable:
52+
53+
```bash
54+
HUBSPOT_API_KEY=your_hubspot_api_key # Required
55+
HUBSPOT_DEFAULT_LIMIT=100 # Optional
56+
```
57+
58+
Get your API key at: [app.hubspot.com/private-apps](https://app.hubspot.com/private-apps)
59+
60+
## Use Cases
61+
62+
- **Analytics & Reporting**: Generate insights from CRM data
63+
- **Customer Research**: Search and analyze customer information
64+
- **Data Discovery**: Explore available properties and data structure
65+
- **AI-Powered Insights**: Let agents analyze CRM data safely
66+
- **Sales Intelligence**: Extract trends and patterns from deals/contacts
67+
- **Lead Analysis**: Research prospects and opportunities
68+
69+
## Resources
70+
71+
- **PyPI**: [pypi.org/project/strands-hubspot](https://pypi.org/project/strands-hubspot/)
72+
- **GitHub**: [github.com/eraykeskinmac/strands-hubspot](https://github.com/eraykeskinmac/strands-hubspot)
73+
- **Examples**: [github.com/eraykeskinmac/strands-tools-examples](https://github.com/eraykeskinmac/strands-tools-examples)

‎docs/community/tools/strands-teams.md‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# strands-teams
2+
3+
{{ community_contribution_banner }}
4+
5+
[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.
6+
7+
## Installation
8+
9+
```bash
10+
pip install strands-teams
11+
```
12+
13+
## Usage
14+
15+
```python
16+
from strands import Agent
17+
from strands_teams import teams
18+
19+
agent = Agent(tools=[teams])
20+
21+
# Simple notification
22+
agent("send a Teams message: New lead from Acme Corp")
23+
24+
# Pre-built templates
25+
agent("send an approval request to Teams for the Q4 budget")
26+
27+
# Status updates
28+
agent("send status update: website redesign is 75% complete")
29+
```
30+
31+
## Key Features
32+
33+
- **Adaptive Cards**: Rich, interactive message cards with modern UI
34+
- **Pre-built Templates**: Notifications, approvals, status updates, and more
35+
- **Action Buttons**: Interactive elements like approve/reject buttons
36+
- **Rich Formatting**: Markdown support, images, and color coding
37+
- **Type Safe**: Full type hints and validation
38+
39+
## Configuration
40+
41+
```bash
42+
TEAMS_WEBHOOK_URL=your_webhook_url # Optional
43+
```
44+
45+
## Resources
46+
47+
- **PyPI**: [pypi.org/project/strands-teams](https://pypi.org/project/strands-teams/)
48+
- **GitHub**: [github.com/eraykeskinmac/strands-teams](https://github.com/eraykeskinmac/strands-teams)

‎docs/community/tools/strands-telegram-listener.md‎

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
# strands-telegram-listener
2+
3+
{{ community_contribution_banner }}
4+
5+
[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.
6+
7+
## Installation
8+
9+
```bash
10+
pip install strands-telegram-listener
11+
pip install strands-telegram # Companion package
12+
```
13+
14+
## Usage
15+
16+
```python
17+
from strands import Agent
18+
from strands_telegram_listener import telegram_listener
19+
20+
agent = Agent(tools=[telegram_listener])
21+
22+
# Start listening for messages
23+
agent("start listening to Telegram messages and respond with AI")
24+
25+
# Get recent message history
26+
agent("show me the last 10 Telegram messages received")
27+
28+
# Check listener status
29+
agent("what's the status of the Telegram listener?")
30+
```
31+
32+
## Key Features
33+
34+
- **Real-time Processing**: Long polling for instant message processing
35+
- **AI Auto-Replies**: Intelligent responses powered by Strands agents
36+
- **Event Storage**: Comprehensive message logging and history (JSONL format)
37+
- **Smart Filtering**: Message deduplication and own message filtering
38+
- **Configurable**: Environment variable control for auto-reply behavior
39+
- **Background Processing**: Non-blocking operation with thread safety
40+
41+
## Configuration
42+
43+
```bash
44+
TELEGRAM_BOT_TOKEN=your_bot_token # Required
45+
STRANDS_TELEGRAM_AUTO_REPLY=true # Optional
46+
STRANDS_TELEGRAM_LISTEN_ONLY_TAG="#support" # Optional
47+
```
48+
49+
## Resources
50+
51+
- **PyPI**: [pypi.org/project/strands-telegram-listener](https://pypi.org/project/strands-telegram-listener/)
52+
- **GitHub**: [github.com/eraykeskinmac/strands-telegram-listener](https://github.com/eraykeskinmac/strands-telegram-listener)

‎docs/community/tools/strands-telegram.md‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# strands-telegram
2+
3+
{{ community_contribution_banner }}
4+
5+
[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.
6+
7+
## Installation
8+
9+
```bash
10+
pip install strands-telegram
11+
```
12+
13+
## Usage
14+
15+
```python
16+
from strands import Agent
17+
from strands_telegram import telegram
18+
19+
agent = Agent(tools=[telegram])
20+
21+
# Send messages
22+
agent("send a Telegram message to @username: Hello from AI agent!")
23+
24+
# Interactive keyboards
25+
agent("send a poll to Telegram: What's your favorite color? Red, Blue, Green")
26+
27+
# Media sharing
28+
agent("send this image to Telegram with caption: image.jpg")
29+
```
30+
31+
## Key Features
32+
33+
- **Complete Bot API**: 60+ Telegram API methods (messages, media, keyboards, polls, groups)
34+
- **Interactive Elements**: Inline keyboards, polls, dice games, location sharing
35+
- **Group Management**: Admin tools, user management, permissions control
36+
- **Media Support**: Photos, videos, documents, audio, stickers, voice messages
37+
- **Webhooks**: Full webhook support for real-time message processing
38+
- **Custom API Calls**: Extensible for any Telegram Bot API method
39+
40+
## Configuration
41+
42+
```bash
43+
TELEGRAM_BOT_TOKEN=your_bot_token # Required from @BotFather
44+
```
45+
46+
## Resources
47+
48+
- **PyPI**: [pypi.org/project/strands-telegram](https://pypi.org/project/strands-telegram/)
49+
- **GitHub**: [github.com/eraykeskinmac/strands-telegram](https://github.com/eraykeskinmac/strands-telegram)

0 commit comments

Comments
 (0)