Skip to content
65 changes: 65 additions & 0 deletions docs/community/tools/strands-deepgram.md
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/)
74 changes: 74 additions & 0 deletions docs/community/tools/strands-hubspot.md
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/)
64 changes: 64 additions & 0 deletions docs/community/tools/strands-teams.md
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)
67 changes: 67 additions & 0 deletions docs/community/tools/strands-telegram-listener.md
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)
65 changes: 65 additions & 0 deletions docs/community/tools/strands-telegram.md
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)
12 changes: 9 additions & 3 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -209,16 +209,22 @@ nav:

- Community:
- Community Packages: community/community-packages.md
- Tools:
- UTCP: community/tools/utcp.md
- Integrations:
- AG-UI: community/integrations/ag-ui.md
- Model Providers:
- Cohere: community/model-providers/cohere.md
- 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:
Expand Down