diff --git a/docs/community/tools/strands-deepgram.md b/docs/community/tools/strands-deepgram.md new file mode 100644 index 00000000..c2cedb90 --- /dev/null +++ b/docs/community/tools/strands-deepgram.md @@ -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) \ No newline at end of file diff --git a/docs/community/tools/strands-hubspot.md b/docs/community/tools/strands-hubspot.md new file mode 100644 index 00000000..76e3b6b8 --- /dev/null +++ b/docs/community/tools/strands-hubspot.md @@ -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) \ No newline at end of file diff --git a/docs/community/tools/strands-teams.md b/docs/community/tools/strands-teams.md new file mode 100644 index 00000000..132ee476 --- /dev/null +++ b/docs/community/tools/strands-teams.md @@ -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) \ No newline at end of file diff --git a/docs/community/tools/strands-telegram-listener.md b/docs/community/tools/strands-telegram-listener.md new file mode 100644 index 00000000..2ad043de --- /dev/null +++ b/docs/community/tools/strands-telegram-listener.md @@ -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) \ No newline at end of file diff --git a/docs/community/tools/strands-telegram.md b/docs/community/tools/strands-telegram.md new file mode 100644 index 00000000..0009c7d6 --- /dev/null +++ b/docs/community/tools/strands-telegram.md @@ -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) \ No newline at end of file