Skip to content

feat: add Perplexity as a provider - #4395

Closed
123mikeyd wants to merge 2 commits into
NousResearch:mainfrom
123mikeyd:feature/add-perplexity-provider
Closed

feat: add Perplexity as a provider#4395
123mikeyd wants to merge 2 commits into
NousResearch:mainfrom
123mikeyd:feature/add-perplexity-provider

Conversation

@123mikeyd

Copy link
Copy Markdown
Contributor

Add Perplexity (Sonar API) as a first-class provider.\n\nPerplexity offers OpenAI-compatible chat completions with built-in web search grounding.\n\n## Changes\n- auth.py: ProviderConfig entry (api_key auth, https://api.perplexity.ai)\n- models.py: Model list (sonar, sonar-pro, sonar-reasoning-pro, sonar-deep-research), labels, aliases (pplx, sonar)\n- config.py: PERPLEXITY_API_KEY and PERPLEXITY_BASE_URL env var definitions\n- setup.py: Setup wizard provider choice and handler\n\n## Usage\n\nhermes setup # select Perplexity from provider list\nhermes -m perplexity:sonar-pro\nhermes -m pplx:sonar-reasoning-pro\n\n\nRequested by a community member in Discord. Perplexity uses standard OpenAI-compatible chat completions so no special adapter needed -- just key + base URL.

Major update to meme-generation skill:

- Path D: Veo/Gemini video memes (text-to-video, image-to-video)
  - Chained scenes for sequential narrative generation
  - Frame interpolation for transition effects
  - Video extension up to 148 seconds
- Path E: Kling AI video memes (image-to-video)
  - Camera control, motion brush, multi-shot storyboarding
  - Voice integration for dialogue
- Path F: Hedra lip-sync video (character singing/speaking)
  - Audio-driven lip sync from still images
  - Music video production workflow
  - Stylized art preservation tips
- Video post-processing section (ffmpeg)
  - Text burn-in, audio overlay, GIF conversion, concatenation
- Provider credential check table
- Video-specific pitfalls

Also includes all prior improvements:
- Path B: Custom Pillow composites (object labels, avatars, memorials)
- Path C: AI-generated art memes
- Nous Research team assets and branding
- Font preferences (Courier New / Liberation Mono Bold)

Co-authored-by: 123mikeyd
Add Perplexity (Sonar API) as a first-class provider. Perplexity offers
OpenAI-compatible chat completions with built-in web search grounding.

Changes:
- auth.py: Add ProviderConfig entry (api_key auth, https://api.perplexity.ai)
- models.py: Add model list (sonar, sonar-pro, sonar-reasoning-pro,
  sonar-deep-research), provider label, aliases (pplx, sonar), provider order
- config.py: Add PERPLEXITY_API_KEY and PERPLEXITY_BASE_URL env var
  definitions, update fallback provider comment templates
- setup.py: Add to setup wizard provider choices and default model list

Usage:
  hermes setup  # select Perplexity from provider list
  hermes -m perplexity:sonar-pro
  hermes -m pplx:sonar-reasoning-pro
@alt-glitch alt-glitch added type/feature New feature or request P3 Low — cosmetic, nice to have comp/cli CLI entry point, hermes_cli/, setup wizard area/config Config system, migrations, profiles labels May 2, 2026
@alt-glitch

Copy link
Copy Markdown
Collaborator

Related to #12832 (feature request for custom OpenAI-compatible search backend including Perplexity) and #9192 (Perplexity as web search backend). Note: Perplexity can already be used via custom_providers since it's OpenAI-compatible — see #15214 for docs.

@alt-glitch

Copy link
Copy Markdown
Collaborator

related

@teknium1

Copy link
Copy Markdown
Contributor

Thanks for the Perplexity integration work. Current main already supports this use case through the named custom-provider path, so this PR is redundant.

  • website/docs/integrations/providers.md:1308 provides the Perplexity recipe with https://api.perplexity.ai, PERPLEXITY_API_KEY, provider: custom:perplexity, and a selectable model.
  • hermes_cli/model_setup_flows.py:780 saves custom OpenAI-compatible endpoints so they appear in the provider menu; hermes_cli/runtime_provider.py:718 resolves their URL, credentials, API mode, and model at runtime.
  • The Perplexity cookbook shipped in acca3ec3af7ebe99f520bd8f3d1e84f6447b57ac (docs(providers): Together/Groq/Perplexity cookbook via custom_providers).
  • This also matches @alt-glitch's linked guidance to use custom_providers and the Perplexity documentation.

Automated hermes-sweeper review.

@teknium1 teknium1 closed this Jul 12, 2026
@teknium1 teknium1 added the sweeper:implemented-on-main Sweeper: behavior already present on current main label Jul 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/config Config system, migrations, profiles comp/cli CLI entry point, hermes_cli/, setup wizard P3 Low — cosmetic, nice to have sweeper:implemented-on-main Sweeper: behavior already present on current main type/feature New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants