[strands-perplexity](https://github.com/mkmeral/strands-perplexity) is a real-time web search tool powered by the [Perplexity Search API](https://docs.perplexity.ai/guides/search-quickstart) with citation support, regional filtering, and multi-query capabilities.

## Installation

```bash
pip install strands-perplexity
```

## Usage

```python
from strands import Agent
from strands_perplexity import perplexity_search

agent = Agent(tools=[perplexity_search])

# Search the web
agent("What are the latest developments in AI?")

# Research a topic
agent("Find recent papers on quantum computing breakthroughs")

# Get current information
agent("What happened in tech news today?")
```

## Key Features

-   **Real-time Web Search**: Access ranked web search results from Perplexity’s continuously refreshed index
-   **Citations Included**: Every result includes URLs for proper attribution
-   **Regional Search**: Filter results by country using ISO country codes
-   **Language Filtering**: Filter results by language using ISO 639-1 codes
-   **Domain Filtering**: Include or exclude specific domains from results
-   **Multi-query Support**: Execute up to 5 related queries in a single request

## Configuration

```bash
PERPLEXITY_API_KEY=your_api_key    # Required
```

Get your API key at: [Perplexity API Settings](https://perplexity.ai/account/api)

## Resources

-   [PyPI Package](https://pypi.org/project/strands-perplexity/)
-   [GitHub Repository](https://github.com/mkmeral/strands-perplexity)
-   [Perplexity Search API Docs](https://docs.perplexity.ai/guides/search-quickstart)
-   [Perplexity Search Best Practices](https://docs.perplexity.ai/guides/search-best-practices)