diff --git a/docs/community/tools/strands-deepgram.md b/docs/community/tools/strands-deepgram.md new file mode 100644 index 00000000..efcb250c --- /dev/null +++ b/docs/community/tools/strands-deepgram.md @@ -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/) diff --git a/docs/community/tools/strands-hubspot.md b/docs/community/tools/strands-hubspot.md new file mode 100644 index 00000000..358ca443 --- /dev/null +++ b/docs/community/tools/strands-hubspot.md @@ -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/) diff --git a/docs/community/tools/strands-teams.md b/docs/community/tools/strands-teams.md new file mode 100644 index 00000000..c11dd451 --- /dev/null +++ b/docs/community/tools/strands-teams.md @@ -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) diff --git a/docs/community/tools/strands-telegram-listener.md b/docs/community/tools/strands-telegram-listener.md new file mode 100644 index 00000000..95cc1d2d --- /dev/null +++ b/docs/community/tools/strands-telegram-listener.md @@ -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) diff --git a/docs/community/tools/strands-telegram.md b/docs/community/tools/strands-telegram.md new file mode 100644 index 00000000..7eaf9492 --- /dev/null +++ b/docs/community/tools/strands-telegram.md @@ -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) diff --git a/mkdocs.yml b/mkdocs.yml index feef936c..de5a0ef7 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -209,8 +209,6 @@ nav: - Community: - Community Packages: community/community-packages.md - - Tools: - - UTCP: community/tools/utcp.md - Integrations: - AG-UI: community/integrations/ag-ui.md - Model Providers: @@ -218,7 +216,15 @@ nav: - 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: