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
Copy link
Member

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:

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/

I know none of the other pages have this content, but I think going forward it would be beneficial


{{ 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.
Copy link
Member

Choose a reason for hiding this comment

The 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

Copy link
Member

Choose a reason for hiding this comment

The 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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
DEEPGRAM_API_KEY=your_deepgram_api_key # Required
DEEPGRAM_DEFAULT_MODEL=nova-3 # Optional
DEEPGRAM_DEFAULT_LANGUAGE=en # Optional
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
Comment on lines +54 to +55
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
HUBSPOT_API_KEY=your_hubspot_api_key # Required
HUBSPOT_DEFAULT_LIMIT=100 # Optional
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)
Copy link
Member

Choose a reason for hiding this comment

The 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)
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)
Loading