Amplifier Perplexity Provider

February 1, 2026 · View on GitHub

Perplexity AI provider for Amplifier, enabling web-grounded AI search with real-time citations.

Installation

Option 1: Amplifier CLI (Recommended)

# Add the provider module
amplifier module add provider-perplexity --source git+https://github.com/colombod/amplifier-module-provider-perplexity@main

# Verify installation
amplifier module list

Option 2: In Your Bundle

Add to your bundle's providers section:

providers:
  - module: provider-perplexity
    source: git+https://github.com/colombod/amplifier-module-provider-perplexity@main
    config:
      default_model: sonar-pro

Option 3: settings.yaml Override

Add to ~/.amplifier/settings.yaml:

modules:
  provider-perplexity:
    source: git+https://github.com/colombod/amplifier-module-provider-perplexity@main
    config:
      default_model: sonar-pro

Environment Setup

Set your Perplexity API key:

export PERPLEXITY_API_KEY="pplx-xxxxxxxxxxxxxxxx"

Or add to your shell profile (~/.bashrc, ~/.zshrc):

echo 'export PERPLEXITY_API_KEY="pplx-xxxxxxxxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

Quick Start

After installation, start Amplifier and it will use Perplexity as a provider:

# Interactive session
amplifier

# Or single query
amplifier run "What are the latest developments in quantum computing?"

Configuration Options

Full configuration reference for settings.yaml or bundle config:

config:
  # Model selection
  default_model: sonar-pro  # sonar, sonar-pro, sonar-reasoning, etc.
  
  # Search settings
  search_recency_filter: week  # none, hour, day, week, month, year
  search_context_size: medium  # low, medium, high
  search_domain_filter:        # Restrict to specific domains
    - example.com
    - docs.example.com
  
  # Response options
  return_images: false
  return_related_questions: false
  
  # Request settings
  max_tokens: 4096
  temperature: 0.7
  timeout: 60.0
  max_retries: 3

Available Models

Model	Context Window	Max Output	Capabilities
`sonar`	128k	4,096	Web search, citations, streaming
`sonar-pro`	200k	8,192	Web search, citations, streaming, deep search
`sonar-reasoning`	128k	4,096	Web search, citations, streaming, reasoning
`sonar-reasoning-pro`	128k	8,192	Web search, citations, streaming, reasoning, deep search
`sonar-deep-research`	128k	8,192	Web search, citations, deep research
`r1-1776`	128k	4,096	Offline (no web search)

Perplexity-Specific Features

Citations

Perplexity responses include citations to web sources. Access them via response metadata:

response = await provider.complete(request)
citations = response.metadata.get("citations", [])
for citation in citations:
    print(f"Source: {citation['url']}")

Search Recency Filter

Control how recent search results should be:

none - No filter (default)
hour - Last hour
day - Last 24 hours
week - Last 7 days
month - Last 30 days
year - Last year

Search Context Size

Control how much search context is included:

low - Minimal context, faster responses
medium - Balanced (default)
high - Maximum context, more comprehensive

Domain Filtering

Restrict searches to specific domains:

config:
  search_domain_filter:
    - wikipedia.org
    - arxiv.org

Enable related question suggestions:

config:
  return_related_questions: true

Access via:

related = response.metadata.get("related_questions", [])

Usage Example

from amplifier_core.message_models import ChatRequest, Message

# Create a request
request = ChatRequest(
    model="sonar",
    messages=[
        Message(role="user", content="What are the latest developments in quantum computing?")
    ],
    max_tokens=2000,
)

# Get response with citations
response = await provider.complete(request)

print(response.content[0].text)

# Access citations
if response.metadata and "citations" in response.metadata:
    print("\nSources:")
    for citation in response.metadata["citations"]:
        print(f"  - {citation.get('title', 'Untitled')}: {citation['url']}")

Error Handling

The provider implements automatic retry with exponential backoff for:

429 (Rate Limited): Uses retry-after header when available
5xx (Server Errors): Retries with exponential backoff

Errors that are not retried:

401 (Unauthorized): Invalid API key - fails immediately

amplifier-bundle-perplexity: Deep research bundle using Perplexity's Agentic Research API (for multi-step research with categorized references)

License

MIT