<!-- 
╔══════════════════════════════════════════════════════════════════════════════════╗
║                            PERPLEXITY OMNIBOX                                    ║
║                      AI Search from Your Address Bar                             ║
╚══════════════════════════════════════════════════════════════════════════════════╝

Author: Adam Lui
License: MIT
Repository: https://github.com/KudoAI/perplexity-omnibox
-->

<div align="center">

<!-- ═══════════════════════════════════════════════════════════════════════════════
     HERO SECTION
     ═══════════════════════════════════════════════════════════════════════════════ -->

<img 
  src=https://cdn.jsdelivr.net/gh/KudoAI/perplexity-omnibox/assets/images/tiles/marquee/edge/tile1400x560.png 
  alt="Perplexity Omnibox Hero Banner" 
  width="100%"
/>

<br>

<h1>Perplexity Omnibox</h1>

**AI search from your address bar**

<br>

<!-- ═══════════════════════════════════════════════════════════════════════════════
     BADGES - Primary Metrics (for-the-badge style)
     ═══════════════════════════════════════════════════════════════════════════════ -->

[![Users][badge-users]][link-edge]
[![Trending][badge-trending]][link-edge]
[![Rating][badge-rating]][link-reviews]

<!-- ═══════════════════════════════════════════════════════════════════════════════
     BADGES - Secondary Metrics (flat-square style)
     ═══════════════════════════════════════════════════════════════════════════════ -->

[![jsDelivr][badge-jsdelivr]][link-jsdelivr]
[![CodeFactor][badge-codefactor]][link-codefactor]
[![SonarCloud][badge-sonar]][link-sonar]
[![License][badge-license]][link-license]

<br>

<!-- ═══════════════════════════════════════════════════════════════════════════════
     INSTALLATION BUTTONS
     ═══════════════════════════════════════════════════════════════════════════════ -->

<a href="https://chromewebstore.google.com/detail/perplexity-omnibox/ckhgddjdjkphbaediggjdddjdjgkalom/?utm_source=github&utm_medium=referral&utm_content=install-button">
  <img 
    src=https://cdn.jsdelivr.net/gh/KudoAI/perplexity-omnibox/assets/images/badges/chrome-web-store/available-in-the-chrome-web-store-green-square-border-light-498x152.png 
    alt="Get for Chrome" 
    height="58"
  />
</a>
<a href="https://microsoftedge.microsoft.com/addons/detail/perplexity-omnibox/ffpccpmmcnampmlpdeioklmdjccfmpih">
  <img 
    src=https://cdn.jsdelivr.net/gh/KudoAI/perplexity-omnibox/assets/images/badges/microsoft-store/get-it-from-microsoft-blue-square-border-light-457x157.png 
    alt="Get for Edge" 
    height="58"
  />
</a>

<br><br>

</div>

---

## 💡 About

<table>
  <tr>
    <td width="50%">
      
### 🚀 Instant Access

Type `@perplexity` in your address bar and get AI-powered answers without opening new tabs.

### 🪶 Ultra Lightweight

Less than 100 KB. Faster than loading a single image.

</td>
    <td width="50%">
      
### 🔒 Privacy First

Zero tracking. Zero data collection. Your searches stay yours.

### 🌐 Universal Support

Works on Chrome, Edge, Opera, Brave, and all Chromium browsers.

</td>
  </tr>
</table>

---

## 🎯 Usage

Simply type `@perplexity` followed by your query in the address bar:

```text
@perplexity what's the weather in Barcelona today?
@perplexity explain quantum entanglement simply
@perplexity best tapas restaurants near me
@perplexity how to center a div in CSS
```

<div align="center">

**It's that simple.** No configuration needed.

</div>

---

## 🌍 Browser Support

| Browser                                                                                                        | Status         | Download                                               |
| -------------------------------------------------------------------------------------------------------------- | -------------- | ------------------------------------------------------ |
| <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/chrome/chrome_48x48.png" width="20"> **Chrome**  | ✅ Supported   | [Install][link-chrome]                                 |
| <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/edge/edge_48x48.png" width="20"> **Edge**        | ✅ Supported   | [Install][link-edge]                                   |
| <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/opera/opera_48x48.png" width="20"> **Opera**     | ✅ Supported   | Via Chrome Store                                       |
| <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/brave/brave_48x48.png" width="20"> **Brave**     | ✅ Supported   | Via Chrome Store                                       |
| <img src="https://raw.githubusercontent.com/alrra/browser-logos/main/src/vivaldi/vivaldi_48x48.png" width="20"> **Vivaldi** | ✅ Supported | Via Chrome Store                                       |

---

## 📊 Stats

<div align="center">

| Metric                  | Value                                      |
| ----------------------- | ------------------------------------------ |
| **Active Users**        | 6,300+                                     |
| **Extension Size**      | < 100 KB                                   |
| **Chrome Rating**       | ⭐⭐⭐⭐⭐                                   |
| **jsDelivr Requests**   | [View Stats →][link-jsdelivr]              |
| **Code Quality**        | A+ Grade                                   |

</div>

---

## 🛠️ Technical Details

<details>
<summary><b>Architecture & Security</b></summary>

<br>

- **Zero Vulnerabilities**: Continuously scanned by SonarCloud
- **A+ Code Quality**: Validated by CodeFactor
- **MIT Licensed**: Open source and transparent
- **No External Dependencies**: Pure vanilla JavaScript
- **Manifest V3**: Latest Chrome extension standards

</details>

<details>
<summary><b>Performance Metrics</b></summary>

<br>

| Metric              | Value                      |
| ------------------- | -------------------------- |
| **Bundle Size**     | 87 KB                      |
| **Load Time**       | < 50ms                     |
| **Memory Usage**    | ~2 MB                      |
| **API Latency**     | Depends on Perplexity.ai   |

</details>

---

## 💖 Sponsors

<div align="center">

<br>

<a href="https://www.warp.dev/chatgptjs" target="_blank">
  <img 
    src="https://assets.chatgptjs.org/images/banners/warp/banner-1500x500.png?v=476e837" 
    width="650" 
    alt="Warp - The AI Terminal"
  />
</a>

<br>

### **[Warp][link-warp]** — The AI terminal for developers

*Available for macOS, Linux & Windows*

<br>

</div>

---

## 🤝 Contributing

Contributions are welcome! Feel free to:

- 🐛 [Report bugs][link-issues-bug]
- 💡 [Suggest features][link-issues-feature]
- 🔧 [Submit pull requests][link-pulls]
- ⭐ [Star the repository][link-stargazers]

---

## 📚 Resources

<div align="center">

[**Documentation**][link-wiki] • 
[**Support**][link-issues] • 
[**Changelog**][link-releases] • 
[**More AI Extensions**][link-ai-extensions]

<br>

Made with ❤️ by [Adam Lui][link-author]

<br>

[![MIT License][badge-license]][link-license]

</div>

<!-- ═══════════════════════════════════════════════════════════════════════════════
     BADGE DEFINITIONS
     ═══════════════════════════════════════════════════════════════════════════════ -->

[badge-users]: https://img.shields.io/badge/Users-6.6K-2563eb?style=for-the-badge&logo=weightsandbiases&logoColor=white
[badge-trending]: https://img.shields.io/badge/Top_20-Edge_Add--on-7bfce9?style=for-the-badge&logo=microsoft-edge&logoColor=white
[badge-rating]: https://img.shields.io/chrome-web-store/stars/ckhgddjdjkphbaediggjdddjdjgkalom?style=for-the-badge&logo=googlechrome&logoColor=white&color=10b981&label=Chrome
[badge-jsdelivr]: https://img.shields.io/jsdelivr/gh/hm/KudoAI/perplexity-omnibox?style=flat-square&logo=jsdelivr&logoColor=white&color=2bbbd8&label=jsDelivr
[badge-codefactor]: https://img.shields.io/codefactor/grade/github/KudoAI/perplexity-omnibox?style=flat-square&logo=codefactor&logoColor=white&color=b3ff68&label=Code%20Quality
[badge-sonar]: https://img.shields.io/badge/Vulnerabilities-6.6K-gold?style=flat-square&logo=sonar&logoColor=white
[badge-license]: https://img.shields.io/badge/License-MIT-e11d48?style=flat-square&logo=opensourceinitiative&logoColor=white

<!-- ═══════════════════════════════════════════════════════════════════════════════
     LINK DEFINITIONS
     ═══════════════════════════════════════════════════════════════════════════════ -->

[link-chrome]: https://chromewebstore.google.com/detail/perplexity-omnibox/ckhgddjdjkphbaediggjdddjdjgkalom
[link-edge]: https://microsoftedge.microsoft.com/addons/detail/perplexity-omnibox/ffpccpmmcnampmlpdeioklmdjccfmpih
[link-reviews]: https://chromewebstore.google.com/detail/perplexity-omnibox/ckhgddjdjkphbaediggjdddjdjgkalom/reviews
[link-jsdelivr]: https://www.jsdelivr.com/package/gh/KudoAI/perplexity-omnibox?tab=stats
[link-codefactor]: https://www.codefactor.io/repository/github/KudoAI/perplexity-omnibox
[link-sonar]: https://sonarcloud.io/component_measures?metric=vulnerabilities&id=adamlui_perplexity-omnibox
[link-license]: ../LICENSE.md
[link-warp]: https://www.warp.dev/chatgptjs
[link-wiki]: https://github.com/KudoAI/perplexity-omnibox/wiki
[link-issues]: https://github.com/KudoAI/perplexity-omnibox/issues
[link-issues-bug]: https://github.com/KudoAI/perplexity-omnibox/issues/new?labels=bug
[link-issues-feature]: https://github.com/KudoAI/perplexity-omnibox/issues/new?labels=enhancement
[link-pulls]: https://github.com/KudoAI/perplexity-omnibox/pulls
[link-stargazers]: https://github.com/KudoAI/perplexity-omnibox/stargazers
[link-releases]: https://github.com/KudoAI/perplexity-omnibox/releases
[link-ai-extensions]: https://aiwebextensions.com
[link-author]: https://github.com/adamlui
