Perplexity CLI is a simple and convenient command-line client for the Perplexity API, allowing users to quickly ask questions and receive answers directly from the terminal.
- Easy querying of the Perplexity API
- Support for various language models
- Optional display of token usage statistics
- Optional display of citations
- Colorful output formatting (with glow support)
- API key handling from environment variable or command-line argument
- Python 3.6+
requestslibrary
No installation is required. You can run the script directly from the GitHub repository or install it locally.Example of local installation:
curl -s https://raw.githubusercontent.com/dawid-szewc/perplexity-cli/main/perplexity.py > ~/.local/bin/perplexity \
chmod +x ~/.local/bin/perplexity \
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc \
echo 'export PERPLEXITY_API_KEY="your-api-key"' >> ~/.bashrcperplexity "What is the meaning of life?"perplexity -uc -m llama-3.1-sonar-large-128k-online "Explain Einstein's theory of relativity"-v,--verbose: Enable debug mode-u,--usage: Show token usage statistics-c,--citations: Show citations-g,--glow: Use Glow-compatible formatting-a API_KEY,--api-key API_KEY: Set the API key (optional, defaults toPERPLEXITY_API_KEYenvironment variable)-m MODEL,--model MODEL: Choose the language model (default: llama-3.1-sonar-small-128k-online)
- llama-3.1-sonar-small-128k-online
- llama-3.1-sonar-large-128k-online
- llama-3.1-sonar-huge-128k-online
Set the PERPLEXITY_API_KEY environment variable with your Perplexity API key:
export PERPLEXITY_API_KEY="your-api-key"This project is released under the MIT License.
Dawid Szewc
We welcome issue reports and suggestions for improvements through GitHub Issues.It's worth noting that the project is actively developed and may contain additional features or changes not included in this description. It's recommended to check the latest documentation in the GitHub repository for the most up-to-date information.