\n \n \n\n $\"Warp$ \n\n\n### **✨ [Try Warp - The AI-Powered Terminal →](https://www.warp.dev/perplexica)**\n\nWarp is revolutionizing development workflows with AI-powered features, modern UX, and blazing-fast performance. Used by developers at top companies worldwide.\n\n

\n\n---\n\nWe'd also like to thank the following partners for their generous support:\n\n\n \n \n \n \n

\n \n $\"Exa\"$ \n \n

\n Exa • The Perfect Web Search API for LLMs - web search, crawling, deep research, and answer APIs\n

\n\n## Installation\n\nThere are mainly 2 ways of installing Perplexica - With Docker, Without Docker. Using Docker is highly recommended.\n\n### Getting Started with Docker (Recommended)\n\nPerplexica can be easily run using Docker. Simply run the following command:\n\n```bash\ndocker run -d -p 3000:3000 -v perplexica-data:/home/perplexica/data -v perplexica-uploads:/home/perplexica/uploads --name perplexica itzcrazykns1337/perplexica:latest\n```\n\nThis will pull and start the Perplexica container with the bundled SearxNG search engine. Once running, open your browser and navigate to http://localhost:3000. You can then configure your settings (API keys, models, etc.) directly in the setup screen.\n\n**Note**: The image includes both Perplexica and SearxNG, so no additional setup is required. The `-v` flags create persistent volumes for your data and uploaded files.\n\n#### Using Perplexica with Your Own SearxNG Instance\n\nIf you already have SearxNG running, you can use the slim version of Perplexica:\n\n```bash\ndocker run -d -p 3000:3000 -e SEARXNG_API_URL=http://your-searxng-url:8080 -v perplexica-data:/home/perplexica/data -v perplexica-uploads:/home/perplexica/uploads --name perplexica itzcrazykns1337/perplexica:slim-latest\n```\n\n**Important**: Make sure your SearxNG instance has:\n\n- JSON format enabled in the settings\n- Wolfram Alpha search engine enabled\n\nReplace `http://your-searxng-url:8080` with your actual SearxNG URL. Then configure your AI provider settings in the setup screen at http://localhost:3000.\n\n#### Advanced Setup (Building from Source)\n\nIf you prefer to build from source or need more control:\n\n1. Ensure Docker is installed and running on your system.\n2. Clone the Perplexica repository:\n\n ```bash\n git clone https://github.com/ItzCrazyKns/Perplexica.git\n ```\n\n3. After cloning, navigate to the directory containing the project files.\n\n4. Build and run using Docker:\n\n ```bash\n docker build -t perplexica .\n docker run -d -p 3000:3000 -v perplexica-data:/home/perplexica/data -v perplexica-uploads:/home/perplexica/uploads --name perplexica perplexica\n ```\n\n5. Access Perplexica at http://localhost:3000 and configure your settings in the setup screen.\n\n**Note**: After the containers are built, you can start Perplexica directly from Docker without having to open a terminal.\n\n### Non-Docker Installation\n\n1. Install SearXNG and allow `JSON` format in the SearXNG settings. Make sure Wolfram Alpha search engine is also enabled.\n2. Clone the repository:\n\n ```bash\n git clone https://github.com/ItzCrazyKns/Perplexica.git\n cd Perplexica\n ```\n\n3. Install dependencies:\n\n ```bash\n npm i\n ```\n\n4. Build the application:\n\n ```bash\n npm run build\n ```\n\n5. Start the application:\n\n ```bash\n npm run start\n ```\n\n6. Open your browser and navigate to http://localhost:3000 to complete the setup and configure your settings (API keys, models, SearxNG URL, etc.) in the setup screen.\n\n**Note**: Using Docker is recommended as it simplifies the setup process, especially for managing environment variables and dependencies.\n\nSee the [installation documentation](https://github.com/ItzCrazyKns/Perplexica/tree/master/docs/installation) for more information like updating, etc.\n\n### Troubleshooting\n\n#### Local OpenAI-API-Compliant Servers\n\nIf Perplexica tells you that you haven't configured any chat model providers, ensure that:\n\n1. Your server is running on `0.0.0.0` (not `127.0.0.1`) and on the same port you put in the API URL.\n2. You have specified the correct model name loaded by your local LLM server.\n3. You have specified the correct API key, or if one is not defined, you have put _something_ in the API key field and not left it empty.\n\n#### Ollama Connection Errors\n\nIf you're encountering an Ollama connection error, it is likely due to the backend being unable to connect to Ollama's API. To fix this issue you can:\n\n1. **Check your Ollama API URL:** Ensure that the API URL is correctly set in the settings menu.\n2. **Update API URL Based on OS:**\n\n - **Windows:** Use `http://host.docker.internal:11434`\n - **Mac:** Use `http://host.docker.internal:11434`\n - **Linux:** Use `http://:11434`\n\n Adjust the port number if you're using a different one.\n\n3. **Linux Users - Expose Ollama to Network:**\n\n - Inside `/etc/systemd/system/ollama.service`, you need to add `Environment=\"OLLAMA_HOST=0.0.0.0:11434\"`. (Change the port number if you are using a different one.) Then reload the systemd manager configuration with `systemctl daemon-reload`, and restart Ollama by `systemctl restart ollama`. For more information see [Ollama docs](https://github.com/ollama/ollama/blob/main/docs/faq.md#setting-environment-variables-on-linux)\n\n - Ensure that the port (default is 11434) is not blocked by your firewall.\n\n#### Lemonade Connection Errors\n\nIf you're encountering a Lemonade connection error, it is likely due to the backend being unable to connect to Lemonade's API. To fix this issue you can:\n\n1. **Check your Lemonade API URL:** Ensure that the API URL is correctly set in the settings menu.\n2. **Update API URL Based on OS:**\n\n - **Windows:** Use `http://host.docker.internal:8000`\n - **Mac:** Use `http://host.docker.internal:8000`\n - **Linux:** Use `http://:8000`\n\n Adjust the port number if you're using a different one.\n\n3. **Ensure Lemonade Server is Running:**\n\n - Make sure your Lemonade server is running and accessible on the configured port (default is 8000).\n - Verify that Lemonade is configured to accept connections from all interfaces (`0.0.0.0`), not just localhost (`127.0.0.1`).\n - Ensure that the port (default is 8000) is not blocked by your firewall.\n\n## Using as a Search Engine\n\nIf you wish to use Perplexica as an alternative to traditional search engines like Google or Bing, or if you want to add a shortcut for quick access from your browser's search bar, follow these steps:\n\n1. Open your browser's settings.\n2. Navigate to the 'Search Engines' section.\n3. Add a new site search with the following URL: `http://localhost:3000/?q=%s`. Replace `localhost` with your IP address or domain name, and `3000` with the port number if Perplexica is not hosted locally.\n4. Click the add button. Now, you can use Perplexica directly from your browser's search bar.\n\n## Using Perplexica's API\n\nPerplexica also provides an API for developers looking to integrate its powerful search engine into their own applications. You can run searches, use multiple models and get answers to your queries.\n\nFor more details, check out the full documentation [here](https://github.com/ItzCrazyKns/Perplexica/tree/master/docs/API/SEARCH.md).\n\n## Expose Perplexica to network\n\nPerplexica runs on Next.js and handles all API requests. It works right away on the same network and stays accessible even with port forwarding.\n\n## One-Click Deployment\n\n[![Deploy to Sealos](https://raw.githubusercontent.com/labring-actions/templates/main/Deploy-on-Sealos.svg)](https://usw.sealos.io/?openapp=system-template%3FtemplateName%3Dperplexica)\n[![Deploy to RepoCloud](https://d16t0pc4846x52.cloudfront.net/deploylobe.svg)](https://repocloud.io/details/?app_id=267)\n[![Run on ClawCloud](https://raw.githubusercontent.com/ClawCloud/Run-Template/refs/heads/main/Run-on-ClawCloud.svg)](https://template.run.claw.cloud/?referralCode=U11MRQ8U9RM4&openapp=system-fastdeploy%3FtemplateName%3Dperplexica)\n[![Deploy on Hostinger](https://assets.hostinger.com/vps/deploy.svg)](https://www.hostinger.com/vps/docker-hosting?compose_url=https://raw.githubusercontent.com/ItzCrazyKns/Perplexica/refs/heads/master/docker-compose.yaml)\n\n## Upcoming Features\n\n- [x] Add settings page\n- [x] Adding support for local LLMs\n- [x] History Saving features\n- [x] Introducing various Focus Modes\n- [x] Adding API support\n- [x] Adding Discover\n- [ ] Finalizing Copilot Mode\n\n## Support Us\n\nIf you find Perplexica useful, consider giving us a star on GitHub. This helps more people discover Perplexica and supports the development of new features. Your support is greatly appreciated.\n\n### Donations\n\nWe also accept donations to help sustain our project. If you would like to contribute, you can use the following options to donate. Thank you for your support!\n\n| Ethereum |\n| ----------------------------------------------------- |\n| Address: `0xB025a84b2F269570Eb8D4b05DEdaA41D8525B6DD` |\n\n## Contribution\n\nPerplexica is built on the idea that AI and large language models should be easy for everyone to use. If you find bugs or have ideas, please share them in via GitHub Issues. For more information on contributing to Perplexica you can read the [CONTRIBUTING.md](CONTRIBUTING.md) file to learn more about Perplexica and how you can contribute to it.\n\n## Help and Support\n\nIf you have any questions or feedback, please feel free to reach out to us. You can create an issue on GitHub or join our Discord server. There, you can connect with other users, share your experiences and reviews, and receive more personalized help. [Click here](https://discord.gg/EFwsmQDgAu) to join the Discord server. To discuss matters outside of regular support, feel free to contact me on Discord at `itzcrazykns`.\n\nThank you for exploring Perplexica, the AI-powered search engine designed to enhance your search experience. We are constantly working to improve Perplexica and expand its capabilities. We value your feedback and contributions which help us make Perplexica even better. Don't forget to check back for updates and new features!\n","has_starred","hub_user","immutable_tags_settings",{"_70":11,"_71":72},"enabled","rules",[73],".*","is_automated","permissions",{"_77":17,"_78":11,"_79":11},"read","write","admin","user","storage_size",780772822,"orgData","recentTags",[86],{"_87":39,"_88":89,"_90":91,"_92":93,"_94":95,"_96":97,"_45":112,"_113":89,"_114":28,"_115":51,"_52":116,"_117":118,"_119":103,"_120":112,"_121":61,"_122":17},"content_type","creator",10669458,"digest","sha256:b5abf10be8626ec8a1235420e24edaa262dee1feb0acaebd7f0893b4b3063b0d","full_size",780752317,"id",1036251171,"images",[98],{"_99":100,"_90":91,"_101":43,"_102":103,"_104":105,"_106":107,"_108":43,"_109":-5,"_110":93,"_58":61,"_111":-5},"architecture","amd64","features","last_pulled","2026-09-16T07:34:54.9277826Z","last_pushed","2025-12-22T19:46:23.175916528Z","os","linux","os_features","os_version","size","variant","2025-12-22T19:46:23.713892Z","last_updater","last_updater_username","media_type","latest","repository",29542435,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_33":132,"_139":140,"_128":149,"_150":11},{"_35":133,"_37":134,"_40":41,"_42":43,"_44":11,"_45":46,"_47":48,"_49":135,"_52":30,"_27":28,"_53":54,"_55":39,"_56":57,"_58":59,"_60":61,"_62":-5,"_63":57,"_64":65,"_66":11,"_67":28,"_68":136,"_74":11,"_75":138,"_80":28,"_81":82},[],[39],[51],{"_70":11,"_71":137},[73],{"_77":17,"_78":11,"_79":11},"tags",{"_141":59,"_142":-5,"_143":-5,"_144":145},"count","next","previous","results",[146],{"_87":39,"_88":89,"_90":91,"_92":93,"_94":95,"_96":147,"_45":112,"_113":89,"_114":28,"_115":51,"_52":116,"_117":118,"_119":103,"_120":112,"_121":61,"_122":17},[148],{"_99":100,"_90":91,"_101":43,"_102":103,"_104":105,"_106":107,"_108":43,"_109":-5,"_110":93,"_58":61,"_111":-5},[],"canDeleteTags","actionData","errors"]

gyarbij/perplexica

Tags for gyarbij/perplexica