Add Perplexity LLM plugin

[jliounis]

Summary

Adds a livekit-plugins-perplexity plugin that exposes Perplexity's OpenAI-compatible chat completions endpoint as a LiveKit Agents LLM.

The plugin is a thin wrapper around livekit-plugins-openai, mirroring the pattern used by livekit-plugins-cerebras and livekit-plugins-baseten:

• base_url = https://api.perplexity.ai
• Default model: sonar-pro
• API key from the PERPLEXITY_API_KEY env var (or argument)
• Reuses the existing OpenAI plugin transport — no new runtime dependencies

from livekit.plugins import perplexity

llm = perplexity.LLM(model="sonar-pro")  # picks up PERPLEXITY_API_KEY

Attribution header

Every outgoing chat request carries X-Pplx-Integration: livekit-agents/<plugin-version> (forwarded via extra_headers on the underlying OpenAI client) so usage from the LiveKit integration can be attributed upstream. A unit test asserts this header is configured.

Test plan

• uv run --package livekit-plugins-perplexity pytest tests/test_plugin_perplexity.py — 4 passed
• uv run ruff check livekit-plugins/livekit-plugins-perplexity tests/test_plugin_perplexity.py — clean
• Plugin imports and LLM() instantiates with PERPLEXITY_API_KEY set; raises a clear ValueError otherwise
• LLM().provider == "Perplexity" and _client.base_url starts with https://api.perplexity.ai

The added tests are pure mocks (no network) and cover: default model, base URL, attribution header, missing-key error, and provider name.

Files

• livekit-plugins/livekit-plugins-perplexity/ — new package (mirrors cerebras/baseten layout)
• tests/test_plugin_perplexity.py — unit tests
• pyproject.toml — register new workspace member

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ jliounis
❌ james-pplx

---

james-pplx seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[devin-ai-integration]

Devin Review found 1 potential issue.

⚠️ 1 issue in files not directly in the diff

⚠️ Missing perplexity optional dependency in livekit-agents/pyproject.toml (livekit-agents/pyproject.toml:102)

Every other standalone plugin package (cerebras, xai, openai, anthropic, etc.) is registered as an optional dependency in livekit-agents/pyproject.toml:59-124 so users can install via pip install livekit-agents[perplexity]. The PR adds the workspace source in the root pyproject.toml:45 but omits the corresponding perplexity = ["livekit-plugins-perplexity>=1.5.6"] entry in livekit-agents/pyproject.toml. For reference, the cerebras plugin added its entry (cerebras = ["livekit-plugins-cerebras>=1.5.6"] at livekit-agents/pyproject.toml:77) when it was first introduced in its PR.

View 3 additional findings in Devin Review.

[tinalenguyen]

Hi @james-pplx, thank you for creating this PR! Could you sign the CLA and add the plugin to livekit-agents/pyproject.toml?

[jliounis]

@tinalenguyen Are we ok to merge?

[jliounis]

Thanks @tinalenguyen, addressed your review comments here.

• Added the perplexity optional dependency to livekit-agents/pyproject.toml.
• Applied the README link suggestion for the Perplexity docs page.
• CLA signing is being handled separately by the PR author.

_{🤖 Comment from PSI}

[tinalenguyen]

thank you!

[devin-ai-integration]

Devin Review found 1 new potential issue.

View 5 additional findings in Devin Review.

[devin-ai-integration]

🔴 Version mismatch: plugin is 1.5.6 but livekit-agents optional dependency requires >=1.5.8

The Perplexity plugin version is set to 1.5.6 in livekit-plugins/livekit-plugins-perplexity/livekit/plugins/perplexity/version.py:15, but the optional dependency declared in livekit-agents/pyproject.toml:103 requires livekit-plugins-perplexity>=1.5.8. Since 1.5.6 < 1.5.8, running pip install livekit-agents[perplexity] would fail to resolve the dependency because the published package version would not satisfy the >=1.5.8 constraint. Every other plugin in the repo (except browser and krisp which have their own versioning) is at version 1.5.8, matching the >=1.5.8 requirement pattern.

Suggested change

	__version__ = "1.5.6"
	__version__ = "1.5.8"

---

Was this helpful? React with 👍 or 👎 to provide feedback.