Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 53 additions & 0 deletions docs/community/tools/strands-deepgram.md
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.

## 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)
73 changes: 73 additions & 0 deletions docs/community/tools/strands-hubspot.md
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
```

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)
48 changes: 48 additions & 0 deletions docs/community/tools/strands-teams.md
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)
52 changes: 52 additions & 0 deletions docs/community/tools/strands-telegram-listener.md
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)
49 changes: 49 additions & 0 deletions docs/community/tools/strands-telegram.md
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)