Features

Installation

Basic Installation

pip install -e.

With Driver Support (Web Interface)

pip install -e".[driver]"patchright install chromium

Development Installation

pip install -e".[dev]"

Quick Start

Basic Usage

importperplexity# Create clientclient=perplexity.Client()# Make a queryresponse=client.search("What is artificial intelligence?")print(response['answer'])

With Account (for enhanced features)

importperplexity# Your Perplexity cookiescookies= {'next-auth.csrf-token':'your-token','next-auth.session-token':'your-session',}client=perplexity.Client(cookies)# Use enhanced modesresponse=client.search("Complex query here",mode='pro',model='gpt-5.2',sources=['scholar'])

Streaming Responses

forchunkinclient.search("Explain quantum computing",stream=True):if'answer'inchunk:print(chunk['answer'],end='',flush=True)

Async Usage

importasyncioimportperplexity_asyncasyncdefmain():client=awaitperplexity_async.Client()response=awaitclient.search("What is machine learning?")print(response['answer'])asyncio.run(main())

Documentation

Usage

Web Interface

importosfromperplexity.driverimportDrivercli=Driver()cli.run(rf'C:\\Users\\{os.getlogin()}\\AppData\\Local\\Google\\Chrome\\User Data')

cli.run(rf'C:\\Users\\{os.getlogin()}\\AppData\\Local\\Google\\Chrome\\User Data',port=9222)

API Usage

Synchronous API

importperplexityperplexity_cli=perplexity.Client()# model = model for mode, which can only be used in own accounts, that is {#     'auto': [None],#     'pro': [None, 'sonar', 'gpt-5.2', 'claude-4.5-sonnet', 'grok-4-1'],#     'reasoning': [None, 'gpt-5.2-thinking', 'claude-4.5-sonnet-thinking', 'gemini-3.0-pro', 'kimi-k2-thinking', 'grok-4.1-reasoning'],#     'deep research': [None]# }# sources = ['web', 'scholar', 'social']# files = a dictionary which has keys as filenames and values as file data# stream = returns a generator when enabled and just final response when disabled# language = ISO 639 code of language you want to use# follow_up = last query info for follow-up queries, you can directly pass response from a query, look at second example below# incognito = Enables incognito mode, for people who are using their own accountresp=perplexity_cli.search('Your query here',mode='auto',model=None,sources=['web'],files={},stream=False,language='en-US',follow_up=None,incognito=False)print(resp)# second example to show how to use follow-up queries and stream responseforiinperplexity_cli.search('Your query here',stream=True,follow_up=resp):print(i)

importperplexityperplexity_cookies= {<yourcookieshere>}perplexity_cli=perplexity.Client(perplexity_cookies)resp=perplexity_cli.search('Your query here',mode='reasoning',model='gpt-5.2-thinking',sources=['web'],files={'myfile.txt':open('file.txt').read()},stream=False,language='en-US',follow_up=None,incognito=False)print(resp)

importperplexityemailnator_cookies= {<yourcookieshere>}perplexity_cli=perplexity.Client()perplexity_cli.create_account(emailnator_cookies)# Creates a new gmail, so your 5 pro queries will be renewed.resp=perplexity_cli.search('Your query here',mode='reasoning',model=None,sources=['web'],files={'myfile.txt':open('file.txt').read()},stream=False,language='en-US',follow_up=None,incognito=False)print(resp)

Asynchronous API

importasyncioimportperplexity_asyncasyncdeftest():perplexity_cli=awaitperplexity_async.Client()# mode = ['auto', 'pro', 'reasoning', 'deep research']# model = model for mode, which can only be used in own accounts, that is {#     'auto': [None],#     'pro': [None, 'sonar', 'gpt-5.2', 'claude-4.5-sonnet', 'grok-4-1'],#     'reasoning': [None, 'gpt-5.2-thinking', 'claude-4.5-sonnet-thinking', 'gemini-3.0-pro', 'kimi-k2-thinking', 'grok-4.1-reasoning'],#     'deep research': [None]# }# sources = ['web', 'scholar', 'social']# files = a dictionary which has keys as filenames and values as file data# stream = returns a generator when enabled and just final response when disabled# language = ISO 639 code of language you want to use# follow_up = last query info for follow-up queries, you can directly pass response from a query, look at second example below# incognito = Enables incognito mode, for people who are using their own accountresp=awaitperplexity_cli.search('Your query here',mode='auto',model=None,sources=['web'],files={},stream=False,language='en-US',follow_up=None,incognito=False)print(resp)# second example to show how to use follow-up queries and stream responseasyncforiinawaitperplexity_cli.search('Your query here',stream=True,follow_up=resp):print(i)asyncio.run(test())

importasyncioimportperplexity_asyncperplexity_cookies= {<yourcookieshere>}asyncdeftest():perplexity_cli=awaitperplexity_async.Client(perplexity_cookies)resp=awaitperplexity_cli.search('Your query here',mode='reasoning',model='gpt-5.2-thinking',sources=['web'],files={'myfile.txt':open('file.txt').read()},stream=False,language='en-US',follow_up=None,incognito=False)print(resp)asyncio.run(test())

importasyncioimportperplexity_asyncemailnator_cookies= {<yourcookieshere>}asyncdeftest():perplexity_cli=awaitperplexity_async.Client()awaitperplexity_cli.create_account(emailnator_cookies)# Creates a new gmail, so your 5 pro queries will be renewed.resp=awaitperplexity_cli.search('Your query here',mode='reasoning',model=None,sources=['web'],files={'myfile.txt':open('file.txt').read()},stream=False,language='en-US',follow_up=None,incognito=False)print(resp)asyncio.run(test())

How to Get Cookies

Perplexity (to use your own account)

Emailnator (for account generating)

API Reference

Client Class

classClient:def__init__(self,cookies:Optional[Dict[str,str]]=None):"""        Initialize Perplexity client.        Args:            cookies: Optional Perplexity account cookies for enhanced features        """defsearch(self,query:str,mode:str='auto',model:Optional[str]=None,sources:List[str]= ['web'],files:Dict[str,Union[str,bytes]]= {},stream:bool=False,language:str='en-US',follow_up:Optional[Dict]=None,incognito:bool=False    )->Union[Dict,Generator]:"""        Search with Perplexity AI.        Args:            query: Search query            mode: Search mode ('auto', 'pro', 'reasoning', 'deep research')            model: Model to use (depends on mode)            sources: Information sources (['web', 'scholar', 'social'])            files: Files to upload {filename: content}            stream: Enable streaming responses            language: ISO 639 language code            follow_up: Previous query for context            incognito: Enable incognito mode        Returns:            Response dict with 'answer' key, or generator if stream=True        """defcreate_account(self,emailnator_cookies:Dict[str,str]):"""        Create new account using Emailnator.        Args:            emailnator_cookies: Emailnator cookies for account creation        """

Available Models

{'auto': [None],'pro': [None,'sonar','gpt-5.2','claude-4.5-sonnet','grok-4-1'],'reasoning': [None,'gpt-5.2-thinking','claude-4.5-sonnet-thinking','gemini-3.0-pro','kimi-k2-thinking','grok-4.1-reasoning'],'deep research': [None]}

Custom Exceptions

fromperplexity.exceptionsimport (PerplexityError,# Base exceptionAuthenticationError,# Authentication failedRateLimitError,# Rate limit exceededNetworkError,# Network issuesValidationError,# Invalid parametersResponseParseError,# Failed to parse responseAccountCreationError,# Account creation failedFileUploadError,# File upload failed)

Testing

Run All Tests

pytest tests/ -v

With Coverage

pytest tests/ --cov=perplexity --cov=perplexity_async --cov-report=html

Run Specific Tests

pytest tests/test_utils.py -vpytest tests/test_config.py -v

Development

Setup Development Environment

# Clone repositorygit clone https://github.com/yourusername/perplexity-ai.gitcd perplexity-ai# Install in development modepip install -e".[dev]"# Run testspytest# Format codeblack perplexity perplexity_async# Check typesmypy perplexity perplexity_async# Lintflake8 perplexity perplexity_async

Contributing

Troubleshooting

Common Issues

Getting Help

Changelog

Roadmap

License

Acknowledgments

Disclaimer