perplexity-web-mcp-cli 0.16.1__tar.gz → 0.17.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/PKG-INFO +62 -61
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/README.md +61 -60
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/pyproject.toml +1 -1
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/pyproject.toml.orig +1 -1
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/api/server.py +258 -240
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/ai_doc.py +56 -55
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/hack.py +1 -1
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/main.py +1 -1
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/council.py +1 -1
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/data/SKILL.md +55 -62
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/data/references/api-endpoints.md +13 -10
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/data/references/mcp-tools.md +26 -23
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/data/references/models.md +44 -68
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/mcp/server.py +86 -60
- perplexity_web_mcp_cli-0.17.1/src/perplexity_web_mcp/models.py +89 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/router.py +3 -3
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/shared.py +53 -56
- perplexity_web_mcp_cli-0.16.1/src/perplexity_web_mcp/models.py +0 -107
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/__init__.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/api/__init__.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/api/responses.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/api/session_manager.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/api/tool_calling.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/auth.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/catalog.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/__init__.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/auth.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/doctor.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/setup.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/cli/skill.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/config.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/connector_policy.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/constants.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/core.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/enums.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/exceptions.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/http.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/limits.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/logging.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/mcp/__init__.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/mcp/__main__.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/preferences.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/py.typed +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/rate_limits.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/resilience.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/sessions.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/token_store.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/trace.py +0 -0
- {perplexity_web_mcp_cli-0.16.1 → perplexity_web_mcp_cli-0.17.1}/src/perplexity_web_mcp/types.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: perplexity-web-mcp-cli
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.17.1
|
|
4
4
|
Summary: CLI, MCP server, and Anthropic/OpenAI API-compatible interface for Perplexity AI.
|
|
5
5
|
Keywords: perplexity,ai,mcp,anthropic,api,client
|
|
6
6
|
Author: Jacob BD
|
|
@@ -62,14 +62,14 @@ Description-Content-Type: text/markdown
|
|
|
62
62
|
|
|
63
63
|
MCP server, CLI, and API-compatible interface for Perplexity AI's web interface.
|
|
64
64
|
|
|
65
|
-
Use your Perplexity Pro/Max subscription to access premium models (
|
|
65
|
+
Use your Perplexity Pro/Max subscription to access premium models (GPT-6.1 Sol, GPT-6 Astra, Gemini 4 Carbon, Gemini 4 Hydrogen, Claude Sonnet 5.5, Claude Opus 5.5, Claude Fable 5.2, Grok 4.7, GLM 5.3, Kimi K3, and Nemotron 3.5 Super VL) from the terminal, through MCP tools, or as an API endpoint.
|
|
66
66
|
|
|
67
67
|
## Features
|
|
68
68
|
|
|
69
69
|
- **CLI**: Query Perplexity models directly from the terminal (`pwm ask`, `pwm chat`, `pwm council`, `pwm research`, `pwm config`)
|
|
70
70
|
- **MCP Server**: MCP tools for AI agents with citations, rate limit checking, and multi-turn context
|
|
71
71
|
- **API Server**: Drop-in Anthropic Messages API and OpenAI Chat Completions API
|
|
72
|
-
- **
|
|
72
|
+
- **Premium Models**: GPT-6.1 Sol, GPT-6 Astra, Gemini 4 Carbon, Gemini 4 Hydrogen, Claude Sonnet 5.5, Claude Opus 5.5, Claude Fable 5.2, Grok 4.7, GLM 5.3, Kimi K3, and Nemotron 3.5 Super VL
|
|
73
73
|
- **Thinking Mode**: Extended thinking support for all compatible models
|
|
74
74
|
- **Deep Research**: Full support for Perplexity's Deep Research mode
|
|
75
75
|
- **Multi-Turn Conversations**: State-preserved threaded conversations for both MCP and CLI REPL
|
|
@@ -177,7 +177,7 @@ pwm ask "What is quantum computing?"
|
|
|
177
177
|
**Choose a specific model** with `-m` (see [Models](#models) for the full list):
|
|
178
178
|
|
|
179
179
|
```bash
|
|
180
|
-
pwm ask "Compare React and Vue" -m
|
|
180
|
+
pwm ask "Compare React and Vue" -m gpt61_sol
|
|
181
181
|
```
|
|
182
182
|
|
|
183
183
|
```bash
|
|
@@ -223,7 +223,7 @@ pwm ask "What is Rust?" --no-citations
|
|
|
223
223
|
**Combine flags** for full control:
|
|
224
224
|
|
|
225
225
|
```bash
|
|
226
|
-
pwm ask "recent advances in protein folding" -m
|
|
226
|
+
pwm ask "recent advances in protein folding" -m gemini4_hydrogen -s academic --json
|
|
227
227
|
```
|
|
228
228
|
|
|
229
229
|
**Long prompts and attachments:**
|
|
@@ -282,13 +282,13 @@ pwm research "NVIDIA competitive landscape" -s finance --json
|
|
|
282
282
|
Query multiple models in parallel and get a synthesized consensus. Each model costs 1 Pro Search. Default synthesis uses Sonar 2 (also 1 Pro Search).
|
|
283
283
|
|
|
284
284
|
```bash
|
|
285
|
-
# Default: GPT-
|
|
285
|
+
# Default: GPT-6.1 Sol, Claude Sonnet 5.5, Gemini 4 Hydrogen + Sonar 2 synthesis (4 Pro Searches)
|
|
286
286
|
pwm council "What are best practices for microservices?"
|
|
287
287
|
```
|
|
288
288
|
|
|
289
289
|
```bash
|
|
290
290
|
# Custom model selection
|
|
291
|
-
pwm council "Compare Rust and Go" -m
|
|
291
|
+
pwm council "Compare Rust and Go" -m gpt61_sol,claude_sonnet
|
|
292
292
|
```
|
|
293
293
|
|
|
294
294
|
```bash
|
|
@@ -337,7 +337,7 @@ Seamlessly launch external AI tools connected to the Perplexity API server. This
|
|
|
337
337
|
|
|
338
338
|
```bash
|
|
339
339
|
pwm hack claude # Launch Claude Code
|
|
340
|
-
pwm hack claude -m
|
|
340
|
+
pwm hack claude -m gpt61_sol # Launch Claude Code with a specific model
|
|
341
341
|
```
|
|
342
342
|
|
|
343
343
|
### MCP Setup
|
|
@@ -398,26 +398,23 @@ pwm --ai # Print comprehensive AI-optimized reference
|
|
|
398
398
|
|
|
399
399
|
## Models
|
|
400
400
|
|
|
401
|
-
| CLI Name
|
|
402
|
-
|
|
|
403
|
-
| `auto`
|
|
404
|
-
| `sonar`
|
|
405
|
-
| `deep_research`
|
|
406
|
-
| `
|
|
407
|
-
| `
|
|
408
|
-
| `
|
|
409
|
-
| `
|
|
410
|
-
| `
|
|
411
|
-
| `
|
|
412
|
-
| `
|
|
413
|
-
| `
|
|
414
|
-
| `
|
|
415
|
-
| `
|
|
416
|
-
| `
|
|
417
|
-
| `
|
|
418
|
-
| `glm53` | Z.ai | Always | GLM 5.3 |
|
|
419
|
-
| `kimi_k26` | Moonshot | Toggle | Kimi K2.6 |
|
|
420
|
-
| `kimi_k3` | Moonshot | Always | Kimi K3 |
|
|
401
|
+
| CLI Name | Provider | Thinking | Notes |
|
|
402
|
+
| ------------------ | ---------- | -------- | ------------------------------------------------ |
|
|
403
|
+
| `auto` | Perplexity | No | Auto-selects best model |
|
|
404
|
+
| `sonar` | Perplexity | No | Sonar 2 (latest in-house; API id `experimental`) |
|
|
405
|
+
| `deep_research` | Perplexity | No | Monthly quota, in-depth reports |
|
|
406
|
+
| `gpt61_sol` | OpenAI | Toggle | GPT-6.1 Sol |
|
|
407
|
+
| `gpt6_astra` | OpenAI | Toggle | GPT-6 Astra (Max tier required) |
|
|
408
|
+
| `gemini4_carbon` | Google | Toggle | Gemini 4 Carbon (Max tier required) |
|
|
409
|
+
| `gemini4_hydrogen` | Google | Toggle | Gemini 4 Hydrogen |
|
|
410
|
+
| `claude_sonnet` | Anthropic | Toggle | Claude Sonnet 5.5 |
|
|
411
|
+
| `claude_opus` | Anthropic | Toggle | Claude Opus 5.5 (Max tier required) |
|
|
412
|
+
| `claude_opus55` | Anthropic | Toggle | Alias for Claude Opus 5.5 (Max tier required) |
|
|
413
|
+
| `claude_fable52` | Anthropic | Toggle | Claude Fable 5.2 (Max tier required) |
|
|
414
|
+
| `grok47` | xAI | Toggle | Grok 4.7 |
|
|
415
|
+
| `nemotron` | NVIDIA | No | Nemotron 3.5 Super VL (text-only) |
|
|
416
|
+
| `glm53` | Z.ai | Always | GLM 5.3 |
|
|
417
|
+
| `kimi_k3` | Moonshot | Always | Kimi K3 |
|
|
421
418
|
|
|
422
419
|
The catalog is server-driven: run `pwm models` to see the live model list (free, no query quota),
|
|
423
420
|
and any identifier it shows can be passed to `pwm ask -m <identifier>`.
|
|
@@ -495,21 +492,23 @@ claude mcp add perplexity pwm-mcp
|
|
|
495
492
|
|
|
496
493
|
**Query tools:**
|
|
497
494
|
|
|
498
|
-
| Tool
|
|
499
|
-
|
|
|
500
|
-
| `pplx_query`
|
|
501
|
-
| `pplx_ask`
|
|
502
|
-
| `pplx_deep_research`
|
|
503
|
-
| `pplx_sonar`
|
|
504
|
-
| `
|
|
505
|
-
| `
|
|
506
|
-
| `
|
|
507
|
-
| `
|
|
508
|
-
| `
|
|
509
|
-
| `
|
|
510
|
-
| `
|
|
511
|
-
| `
|
|
512
|
-
| `
|
|
495
|
+
| Tool | Description |
|
|
496
|
+
| ------------------------------------------------------ | ------------------------------------------- |
|
|
497
|
+
| `pplx_query` | Flexible: model selection + thinking toggle |
|
|
498
|
+
| `pplx_ask` | Quick Q&A (auto-selects best model) |
|
|
499
|
+
| `pplx_deep_research` | In-depth reports with sources |
|
|
500
|
+
| `pplx_sonar` | Perplexity Sonar 2 (1 Pro Search) |
|
|
501
|
+
| `pplx_gpt61_sol` / `pplx_gpt61_sol_thinking` | GPT-6.1 Sol |
|
|
502
|
+
| `pplx_gpt6_astra` / `pplx_gpt6_astra_thinking` | GPT-6 Astra (Max tier) |
|
|
503
|
+
| `pplx_gemini4_carbon` / `pplx_gemini4_carbon_thinking` | Gemini 4 Carbon (Max tier) |
|
|
504
|
+
| `pplx_gemini4_hydrogen` / `..._thinking` | Gemini 4 Hydrogen |
|
|
505
|
+
| `pplx_claude_sonnet` / `pplx_claude_sonnet_think` | Claude Sonnet 5.5 |
|
|
506
|
+
| `pplx_claude_opus` / `pplx_claude_opus_think` | Claude Opus 5.5 (Max tier) |
|
|
507
|
+
| `pplx_claude_fable52` / `pplx_claude_fable52_think` | Claude Fable 5.2 (Max tier) |
|
|
508
|
+
| `pplx_grok47` / `pplx_grok47_thinking` | Grok 4.7 |
|
|
509
|
+
| `pplx_nemotron` | Nemotron 3.5 Super VL |
|
|
510
|
+
| `pplx_glm53` | GLM 5.3 (thinking always on) |
|
|
511
|
+
| `pplx_kimi_k3` | Kimi K3 (thinking always on) |
|
|
513
512
|
|
|
514
513
|
**Smart routing (1):**
|
|
515
514
|
|
|
@@ -525,12 +524,12 @@ claude mcp add perplexity pwm-mcp
|
|
|
525
524
|
|
|
526
525
|
**Usage, connectors & auth tools (5):**
|
|
527
526
|
|
|
528
|
-
| Tool | Description
|
|
529
|
-
| ------------------------ |
|
|
530
|
-
| `pplx_usage` | Check remaining quotas
|
|
531
|
-
| `pplx_connectors` | List connector source IDs
|
|
532
|
-
| `pplx_auth_status` | Check authentication status
|
|
533
|
-
| `pplx_auth_request_code` | Send verification code to email
|
|
527
|
+
| Tool | Description |
|
|
528
|
+
| ------------------------ | -------------------------------------- |
|
|
529
|
+
| `pplx_usage` | Check remaining quotas |
|
|
530
|
+
| `pplx_connectors` | List connector source IDs |
|
|
531
|
+
| `pplx_auth_status` | Check authentication status |
|
|
532
|
+
| `pplx_auth_request_code` | Send verification code to email |
|
|
534
533
|
| `pplx_auth_complete` | Complete email and TOTP authentication |
|
|
535
534
|
|
|
536
535
|
All query tools support `source_focus`: `none`, `web`, `academic`, `social`, `finance`, `all`, or a connector source ID returned by `pplx_connectors()`.
|
|
@@ -592,21 +591,23 @@ export OPENAI_API_KEY=dummy
|
|
|
592
591
|
codex -m sonar --local-provider lmstudio
|
|
593
592
|
```
|
|
594
593
|
|
|
595
|
-
Our server's `MODEL_MAP` will seamlessly intercept `sonar` (or any other mapped names like `gemini-
|
|
594
|
+
Our server's `MODEL_MAP` will seamlessly intercept `sonar` (or any other mapped names like `gemini-4-hydrogen`, `nemotron`, `glm-5.3`, `claude-sonnet-5-5`) and correctly route it to Perplexity's API. You can also create an alias in your shell to make this easier: `alias codex-pplx="codex --local-provider lmstudio"`.
|
|
596
595
|
|
|
597
596
|
### API Model Names
|
|
598
597
|
|
|
599
|
-
| API Name
|
|
600
|
-
|
|
|
601
|
-
| `perplexity-auto`
|
|
602
|
-
| `gpt-
|
|
603
|
-
| `gpt-
|
|
604
|
-
| `
|
|
605
|
-
| `
|
|
606
|
-
| `claude-
|
|
607
|
-
| `
|
|
608
|
-
| `
|
|
609
|
-
| `
|
|
598
|
+
| API Name | Perplexity Model | Thinking |
|
|
599
|
+
| ----------------------- | --------------------- | -------- |
|
|
600
|
+
| `perplexity-auto` | Best (auto-select) | No |
|
|
601
|
+
| `gpt-6.1-sol` | GPT-6.1 Sol | Toggle |
|
|
602
|
+
| `gpt-6-astra` | GPT-6 Astra | Toggle |
|
|
603
|
+
| `gemini-4-carbon` | Gemini 4 Carbon | Toggle |
|
|
604
|
+
| `gemini-4-hydrogen` | Gemini 4 Hydrogen | Toggle |
|
|
605
|
+
| `claude-sonnet-5-5` | Claude Sonnet 5.5 | Toggle |
|
|
606
|
+
| `claude-opus-5-5` | Claude Opus 5.5 | Toggle |
|
|
607
|
+
| `claude-fable-5-2` | Claude Fable 5.2 | Toggle |
|
|
608
|
+
| `grok-4.7` | Grok 4.7 | Toggle |
|
|
609
|
+
| `glm-5.3` / `glm53` | GLM 5.3 | Always |
|
|
610
|
+
| `nemotron-3.5-super-vl` | Nemotron 3.5 Super VL | No |
|
|
610
611
|
|
|
611
612
|
Legacy aliases (`claude-3-5-sonnet`, `claude-3-opus`) are supported for compatibility.
|
|
612
613
|
|
|
@@ -24,14 +24,14 @@
|
|
|
24
24
|
|
|
25
25
|
MCP server, CLI, and API-compatible interface for Perplexity AI's web interface.
|
|
26
26
|
|
|
27
|
-
Use your Perplexity Pro/Max subscription to access premium models (
|
|
27
|
+
Use your Perplexity Pro/Max subscription to access premium models (GPT-6.1 Sol, GPT-6 Astra, Gemini 4 Carbon, Gemini 4 Hydrogen, Claude Sonnet 5.5, Claude Opus 5.5, Claude Fable 5.2, Grok 4.7, GLM 5.3, Kimi K3, and Nemotron 3.5 Super VL) from the terminal, through MCP tools, or as an API endpoint.
|
|
28
28
|
|
|
29
29
|
## Features
|
|
30
30
|
|
|
31
31
|
- **CLI**: Query Perplexity models directly from the terminal (`pwm ask`, `pwm chat`, `pwm council`, `pwm research`, `pwm config`)
|
|
32
32
|
- **MCP Server**: MCP tools for AI agents with citations, rate limit checking, and multi-turn context
|
|
33
33
|
- **API Server**: Drop-in Anthropic Messages API and OpenAI Chat Completions API
|
|
34
|
-
- **
|
|
34
|
+
- **Premium Models**: GPT-6.1 Sol, GPT-6 Astra, Gemini 4 Carbon, Gemini 4 Hydrogen, Claude Sonnet 5.5, Claude Opus 5.5, Claude Fable 5.2, Grok 4.7, GLM 5.3, Kimi K3, and Nemotron 3.5 Super VL
|
|
35
35
|
- **Thinking Mode**: Extended thinking support for all compatible models
|
|
36
36
|
- **Deep Research**: Full support for Perplexity's Deep Research mode
|
|
37
37
|
- **Multi-Turn Conversations**: State-preserved threaded conversations for both MCP and CLI REPL
|
|
@@ -139,7 +139,7 @@ pwm ask "What is quantum computing?"
|
|
|
139
139
|
**Choose a specific model** with `-m` (see [Models](#models) for the full list):
|
|
140
140
|
|
|
141
141
|
```bash
|
|
142
|
-
pwm ask "Compare React and Vue" -m
|
|
142
|
+
pwm ask "Compare React and Vue" -m gpt61_sol
|
|
143
143
|
```
|
|
144
144
|
|
|
145
145
|
```bash
|
|
@@ -185,7 +185,7 @@ pwm ask "What is Rust?" --no-citations
|
|
|
185
185
|
**Combine flags** for full control:
|
|
186
186
|
|
|
187
187
|
```bash
|
|
188
|
-
pwm ask "recent advances in protein folding" -m
|
|
188
|
+
pwm ask "recent advances in protein folding" -m gemini4_hydrogen -s academic --json
|
|
189
189
|
```
|
|
190
190
|
|
|
191
191
|
**Long prompts and attachments:**
|
|
@@ -244,13 +244,13 @@ pwm research "NVIDIA competitive landscape" -s finance --json
|
|
|
244
244
|
Query multiple models in parallel and get a synthesized consensus. Each model costs 1 Pro Search. Default synthesis uses Sonar 2 (also 1 Pro Search).
|
|
245
245
|
|
|
246
246
|
```bash
|
|
247
|
-
# Default: GPT-
|
|
247
|
+
# Default: GPT-6.1 Sol, Claude Sonnet 5.5, Gemini 4 Hydrogen + Sonar 2 synthesis (4 Pro Searches)
|
|
248
248
|
pwm council "What are best practices for microservices?"
|
|
249
249
|
```
|
|
250
250
|
|
|
251
251
|
```bash
|
|
252
252
|
# Custom model selection
|
|
253
|
-
pwm council "Compare Rust and Go" -m
|
|
253
|
+
pwm council "Compare Rust and Go" -m gpt61_sol,claude_sonnet
|
|
254
254
|
```
|
|
255
255
|
|
|
256
256
|
```bash
|
|
@@ -299,7 +299,7 @@ Seamlessly launch external AI tools connected to the Perplexity API server. This
|
|
|
299
299
|
|
|
300
300
|
```bash
|
|
301
301
|
pwm hack claude # Launch Claude Code
|
|
302
|
-
pwm hack claude -m
|
|
302
|
+
pwm hack claude -m gpt61_sol # Launch Claude Code with a specific model
|
|
303
303
|
```
|
|
304
304
|
|
|
305
305
|
### MCP Setup
|
|
@@ -360,26 +360,23 @@ pwm --ai # Print comprehensive AI-optimized reference
|
|
|
360
360
|
|
|
361
361
|
## Models
|
|
362
362
|
|
|
363
|
-
| CLI Name
|
|
364
|
-
|
|
|
365
|
-
| `auto`
|
|
366
|
-
| `sonar`
|
|
367
|
-
| `deep_research`
|
|
368
|
-
| `
|
|
369
|
-
| `
|
|
370
|
-
| `
|
|
371
|
-
| `
|
|
372
|
-
| `
|
|
373
|
-
| `
|
|
374
|
-
| `
|
|
375
|
-
| `
|
|
376
|
-
| `
|
|
377
|
-
| `
|
|
378
|
-
| `
|
|
379
|
-
| `
|
|
380
|
-
| `glm53` | Z.ai | Always | GLM 5.3 |
|
|
381
|
-
| `kimi_k26` | Moonshot | Toggle | Kimi K2.6 |
|
|
382
|
-
| `kimi_k3` | Moonshot | Always | Kimi K3 |
|
|
363
|
+
| CLI Name | Provider | Thinking | Notes |
|
|
364
|
+
| ------------------ | ---------- | -------- | ------------------------------------------------ |
|
|
365
|
+
| `auto` | Perplexity | No | Auto-selects best model |
|
|
366
|
+
| `sonar` | Perplexity | No | Sonar 2 (latest in-house; API id `experimental`) |
|
|
367
|
+
| `deep_research` | Perplexity | No | Monthly quota, in-depth reports |
|
|
368
|
+
| `gpt61_sol` | OpenAI | Toggle | GPT-6.1 Sol |
|
|
369
|
+
| `gpt6_astra` | OpenAI | Toggle | GPT-6 Astra (Max tier required) |
|
|
370
|
+
| `gemini4_carbon` | Google | Toggle | Gemini 4 Carbon (Max tier required) |
|
|
371
|
+
| `gemini4_hydrogen` | Google | Toggle | Gemini 4 Hydrogen |
|
|
372
|
+
| `claude_sonnet` | Anthropic | Toggle | Claude Sonnet 5.5 |
|
|
373
|
+
| `claude_opus` | Anthropic | Toggle | Claude Opus 5.5 (Max tier required) |
|
|
374
|
+
| `claude_opus55` | Anthropic | Toggle | Alias for Claude Opus 5.5 (Max tier required) |
|
|
375
|
+
| `claude_fable52` | Anthropic | Toggle | Claude Fable 5.2 (Max tier required) |
|
|
376
|
+
| `grok47` | xAI | Toggle | Grok 4.7 |
|
|
377
|
+
| `nemotron` | NVIDIA | No | Nemotron 3.5 Super VL (text-only) |
|
|
378
|
+
| `glm53` | Z.ai | Always | GLM 5.3 |
|
|
379
|
+
| `kimi_k3` | Moonshot | Always | Kimi K3 |
|
|
383
380
|
|
|
384
381
|
The catalog is server-driven: run `pwm models` to see the live model list (free, no query quota),
|
|
385
382
|
and any identifier it shows can be passed to `pwm ask -m <identifier>`.
|
|
@@ -457,21 +454,23 @@ claude mcp add perplexity pwm-mcp
|
|
|
457
454
|
|
|
458
455
|
**Query tools:**
|
|
459
456
|
|
|
460
|
-
| Tool
|
|
461
|
-
|
|
|
462
|
-
| `pplx_query`
|
|
463
|
-
| `pplx_ask`
|
|
464
|
-
| `pplx_deep_research`
|
|
465
|
-
| `pplx_sonar`
|
|
466
|
-
| `
|
|
467
|
-
| `
|
|
468
|
-
| `
|
|
469
|
-
| `
|
|
470
|
-
| `
|
|
471
|
-
| `
|
|
472
|
-
| `
|
|
473
|
-
| `
|
|
474
|
-
| `
|
|
457
|
+
| Tool | Description |
|
|
458
|
+
| ------------------------------------------------------ | ------------------------------------------- |
|
|
459
|
+
| `pplx_query` | Flexible: model selection + thinking toggle |
|
|
460
|
+
| `pplx_ask` | Quick Q&A (auto-selects best model) |
|
|
461
|
+
| `pplx_deep_research` | In-depth reports with sources |
|
|
462
|
+
| `pplx_sonar` | Perplexity Sonar 2 (1 Pro Search) |
|
|
463
|
+
| `pplx_gpt61_sol` / `pplx_gpt61_sol_thinking` | GPT-6.1 Sol |
|
|
464
|
+
| `pplx_gpt6_astra` / `pplx_gpt6_astra_thinking` | GPT-6 Astra (Max tier) |
|
|
465
|
+
| `pplx_gemini4_carbon` / `pplx_gemini4_carbon_thinking` | Gemini 4 Carbon (Max tier) |
|
|
466
|
+
| `pplx_gemini4_hydrogen` / `..._thinking` | Gemini 4 Hydrogen |
|
|
467
|
+
| `pplx_claude_sonnet` / `pplx_claude_sonnet_think` | Claude Sonnet 5.5 |
|
|
468
|
+
| `pplx_claude_opus` / `pplx_claude_opus_think` | Claude Opus 5.5 (Max tier) |
|
|
469
|
+
| `pplx_claude_fable52` / `pplx_claude_fable52_think` | Claude Fable 5.2 (Max tier) |
|
|
470
|
+
| `pplx_grok47` / `pplx_grok47_thinking` | Grok 4.7 |
|
|
471
|
+
| `pplx_nemotron` | Nemotron 3.5 Super VL |
|
|
472
|
+
| `pplx_glm53` | GLM 5.3 (thinking always on) |
|
|
473
|
+
| `pplx_kimi_k3` | Kimi K3 (thinking always on) |
|
|
475
474
|
|
|
476
475
|
**Smart routing (1):**
|
|
477
476
|
|
|
@@ -487,12 +486,12 @@ claude mcp add perplexity pwm-mcp
|
|
|
487
486
|
|
|
488
487
|
**Usage, connectors & auth tools (5):**
|
|
489
488
|
|
|
490
|
-
| Tool | Description
|
|
491
|
-
| ------------------------ |
|
|
492
|
-
| `pplx_usage` | Check remaining quotas
|
|
493
|
-
| `pplx_connectors` | List connector source IDs
|
|
494
|
-
| `pplx_auth_status` | Check authentication status
|
|
495
|
-
| `pplx_auth_request_code` | Send verification code to email
|
|
489
|
+
| Tool | Description |
|
|
490
|
+
| ------------------------ | -------------------------------------- |
|
|
491
|
+
| `pplx_usage` | Check remaining quotas |
|
|
492
|
+
| `pplx_connectors` | List connector source IDs |
|
|
493
|
+
| `pplx_auth_status` | Check authentication status |
|
|
494
|
+
| `pplx_auth_request_code` | Send verification code to email |
|
|
496
495
|
| `pplx_auth_complete` | Complete email and TOTP authentication |
|
|
497
496
|
|
|
498
497
|
All query tools support `source_focus`: `none`, `web`, `academic`, `social`, `finance`, `all`, or a connector source ID returned by `pplx_connectors()`.
|
|
@@ -554,21 +553,23 @@ export OPENAI_API_KEY=dummy
|
|
|
554
553
|
codex -m sonar --local-provider lmstudio
|
|
555
554
|
```
|
|
556
555
|
|
|
557
|
-
Our server's `MODEL_MAP` will seamlessly intercept `sonar` (or any other mapped names like `gemini-
|
|
556
|
+
Our server's `MODEL_MAP` will seamlessly intercept `sonar` (or any other mapped names like `gemini-4-hydrogen`, `nemotron`, `glm-5.3`, `claude-sonnet-5-5`) and correctly route it to Perplexity's API. You can also create an alias in your shell to make this easier: `alias codex-pplx="codex --local-provider lmstudio"`.
|
|
558
557
|
|
|
559
558
|
### API Model Names
|
|
560
559
|
|
|
561
|
-
| API Name
|
|
562
|
-
|
|
|
563
|
-
| `perplexity-auto`
|
|
564
|
-
| `gpt-
|
|
565
|
-
| `gpt-
|
|
566
|
-
| `
|
|
567
|
-
| `
|
|
568
|
-
| `claude-
|
|
569
|
-
| `
|
|
570
|
-
| `
|
|
571
|
-
| `
|
|
560
|
+
| API Name | Perplexity Model | Thinking |
|
|
561
|
+
| ----------------------- | --------------------- | -------- |
|
|
562
|
+
| `perplexity-auto` | Best (auto-select) | No |
|
|
563
|
+
| `gpt-6.1-sol` | GPT-6.1 Sol | Toggle |
|
|
564
|
+
| `gpt-6-astra` | GPT-6 Astra | Toggle |
|
|
565
|
+
| `gemini-4-carbon` | Gemini 4 Carbon | Toggle |
|
|
566
|
+
| `gemini-4-hydrogen` | Gemini 4 Hydrogen | Toggle |
|
|
567
|
+
| `claude-sonnet-5-5` | Claude Sonnet 5.5 | Toggle |
|
|
568
|
+
| `claude-opus-5-5` | Claude Opus 5.5 | Toggle |
|
|
569
|
+
| `claude-fable-5-2` | Claude Fable 5.2 | Toggle |
|
|
570
|
+
| `grok-4.7` | Grok 4.7 | Toggle |
|
|
571
|
+
| `glm-5.3` / `glm53` | GLM 5.3 | Always |
|
|
572
|
+
| `nemotron-3.5-super-vl` | Nemotron 3.5 Super VL | No |
|
|
572
573
|
|
|
573
574
|
Legacy aliases (`claude-3-5-sonnet`, `claude-3-opus`) are supported for compatibility.
|
|
574
575
|
|