# helallao/perplexity-ai

Unofficial API Wrapper for Perplexity.ai + Account Generator with Web Interface

Repository: https://github.com/helallao/perplexity-ai
Canonical: https://ross.abutalabs.com/products/perplexity-ai
Homepage: https://perplexity.ai
Language: Python
License: MIT
License Family: permissive
Topics: ai, api, artificial-intelligence, chatgpt, gpt, language-model, language-models, perplexity
Last push: 2026-08-16T11:25:50+00:00

## Health v2 (maintenance only)
Score: 73/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 35, longevity 84
- inputs: {"age_days": 1178, "days_push": 17, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1858, forks 327 (observed 2026-08-28T04:05:45.186269+00:00)

## What it is
An unofficial Python wrapper for Perplexity.ai that reverse-engineers the web interface, supporting sync and async APIs, streaming responses, file uploads, and an MCP server. It also includes an account generator using Emailnator to bypass query limits, plus an optional web interface.

## Use cases
- query perplexity.ai from python without an api key
- expose perplexity search as mcp tools for claude
- generate disposable accounts to bypass perplexity query limits
- stream perplexity answers in a python app
- ask questions about uploaded documents via perplexity

## When to choose
- you want programmatic access to Perplexity without paying for the official API
- you need an MCP server that provides Perplexity search to Claude Code or other MCP clients
- you want both sync and async clients with streaming support

## When to avoid
- you need a stable, officially supported API with guaranteed terms of service compliance
- you cannot rely on reverse-engineered endpoints that may break when Perplexity changes its site
- account generation to bypass limits violates the provider's terms and may risk bans

## Facets
- artifact type: library
- maturity: active
- function: http-client, sdk, mcp, chatbot, web-scraping
- domain: artificial-intelligence, large-language-models, apis, developer-tools
- platform: python, cli
- tags: perplexity, unofficial-api, account-generator, reverse-engineered, sync-async, mcp-server, web-server

## Member repositories
- helallao/perplexity-ai (main) score 73

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:45.186269+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:16:12.898007+00:00, confidence not recorded.
  - readme: https://github.com/helallao/perplexity-ai (fetched 2026-08-28T04:05:45.186269+00:00, sha 8b4d5d476169)
  - homepage: https://perplexity.ai (fetched 2026-08-29T10:55:26.290676+00:00, sha dfafc3a51730)
- Data as of 2026-08-30T08:39:29.467469+00:00.