pairit 0.4.0__tar.gz

pairit-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Naveen Kumar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pairit-0.4.0/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: pairit
+Version: 0.4.0
+Summary: Turn your browser AI sessions into a local development interface
+Author: Naveen Kumar
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/naveenkumarr1812/PairIt
+Project-URL: Repository, https://github.com/naveenkumarr1812/PairIt
+Project-URL: Issues, https://github.com/naveenkumarr1812/PairIt/issues
+Keywords: pairit,ai,chatgpt,claude,gemini,browser,bridge,router,chrome-extension
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp<4,>=3.9
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/naveenkumarr1812/PairIt/main/assets/logo.png" alt="pAIrit – Your Code. Your Browser. Your AI." width="600"/>
+</p>
+
+<p align="center">
+  <strong>Turn your browser AI sessions into a local development interface</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/pairit/"><img src="https://img.shields.io/pypi/v/pairit?color=7C3AED&label=PyPI&style=flat-square" alt="PyPI version"/></a>
+  <a href="https://pypi.org/project/pairit/"><img src="https://img.shields.io/pypi/pyversions/pairit?color=EA580C&style=flat-square" alt="Python versions"/></a>
+  <img src="https://img.shields.io/badge/Chrome%20Extension-MV3-4285F4?style=flat-square&logo=googlechrome&logoColor=white" alt="Chrome MV3"/>
+  <img src="https://img.shields.io/badge/license-MIT-22C55E?style=flat-square" alt="License MIT"/>
+</p>
+
+---
+
+## What is pAIrit?
+
+**pAIrit** is a developer-focused bridge that lets a local Python application talk to AI services — **ChatGPT, Claude, and Gemini** — through the browser tabs you already have open. No API keys, no separate billing; your Python code sends a request, pAIrit routes it to the right browser tab, and streams the answer back.
+
+> **Note:** pAIrit is intended for local development workflows where the developer is already authenticated with the AI services in their browser.
+
+---
+
+## How It Works
+
+```
+Your Python Application
+        │
+        ▼
+    pairit SDK  (pip install pairit)
+        │
+        │  WebSocket
+        ▼
+  Local pairit Bridge
+        │
+        │  Persistent connection
+        ▼
+  PairIt Chrome Extension
+    ┌────┴────┬───────┐
+    ▼         ▼       ▼
+ ChatGPT   Claude   Gemini
+  (tab)    (tab)    (tab)
+```
+
+**Design highlights:**
+
+- Your app opens **one** WebSocket connection to the bridge — not a separate connection per provider.
+- The extension locates a provider tab only when a request for that provider arrives.
+- If the required tab is missing, PairIt returns a clear error:
+  `Claude is not open. Open Claude in a Chrome tab and try again.`
+
+---
+
+## Features
+
+| Feature | Details |
+|---|---|
+| 🔄 **Multi-provider** | ChatGPT, Claude, Gemini — switch with one line |
+| 📡 **Streaming** | Real-time browser-side streaming via DOM observer |
+| 🔐 **No API keys** | Uses your existing logged-in browser sessions |
+| 🪟 **Minimized Chrome** | Bridge stays alive even when Chrome is hidden |
+| 🐍 **Python ≥ 3.10** | Async-first, built on `aiohttp` |
+| 🧩 **Chrome MV3** | Modern Manifest V3 extension |
+
+---
+
+## Installation
+
+### 1. Install the Python package
+
+```bash
+pip install pairit
+```
+
+### 2. Load the Chrome extension
+
+The easiest option is to install PairIt directly from the [Chrome Web Store](https://chromewebstore.google.com/detail/pair/pkcgibncheoddhpfieekkjdffpmmenie).
+
+1. Open the [Chrome Web Store listing](https://chromewebstore.google.com/detail/pair/pkcgibncheoddhpfieekkjdffpmmenie).
+2. Click **Add to Chrome** and confirm the installation.
+3. Pin the **PairIt** extension to your toolbar.
+
+---
+
+## Quick Start
+
+### Basic request
+
+```python
+from pairit import Client
+
+client = Client(provider="chatgpt")
+
+try:
+    response = client.chat("Explain async programming in Python")
+    print(response.content)
+finally:
+    client.close()
+```
+
+### Streaming
+
+```python
+from pairit import Client
+
+client = Client(provider="chatgpt")
+
+try:
+    for chunk in client.chat("Explain Retrieval-Augmented Generation", stream=True):
+        print(chunk.content, end="", flush=True)
+    print()
+finally:
+    client.close()
+```
+
+> `stream=False` (default) returns the full response after generation completes.
+
+---
+
+## Developer Workflow
+
+1. **Run** your Python script — the bridge starts automatically.
+2. **Open** the required AI provider tabs in Chrome and stay logged in.
+3. **Open** the PairIt extension popup and toggle it **ON**.
+4. PairIt continuously attempts to connect to the bridge while the toggle is on.
+5. **Send** requests from your code — pairit handles routing.
+6. When finished, toggle the extension **OFF**.
+
+> The extension does **not** auto-enable on a new Chrome session. You must turn it on manually to keep control explicit.
+
+---
+
+## Status Model
+
+PairIt tracks two independent states:
+
+| State | Description |
+|---|---|
+| **Bridge connection** | Local Python app ↔ Chrome extension (WebSocket) |
+| **Provider availability** | Whether a ChatGPT / Claude / Gemini tab is currently open |
+
+A provider does **not** need to be permanently connected — it only needs to be open at the moment a request targets it.
+
+---
+
+## Safety & Scope
+
+pAIrit is a development-only tool. It **does not**:
+
+- ❌ Extract or store cookies
+- ❌ Bypass authentication
+- ❌ Circumvent anti-bot protections
+- ❌ Automatically switch providers to evade rate limits
+
+---
+
+## Requirements
+
+- Python **≥ 3.10**
+- Google Chrome (with the PairIt extension loaded)
+- Active browser sessions for the AI providers you intend to use
+
+---
+
+## Contributing
+
+Contributions are welcome! For substantial changes, please open an issue first to discuss the proposed modification.
+
+---
+
+<p align="center">
+  Made with ❤️ by pAIrit contributors
+</p>

pairit-0.4.0/README.md

@@ -0,0 +1,175 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/naveenkumarr1812/PairIt/main/assets/logo.png" alt="pAIrit – Your Code. Your Browser. Your AI." width="600"/>
+</p>
+
+<p align="center">
+  <strong>Turn your browser AI sessions into a local development interface</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/pairit/"><img src="https://img.shields.io/pypi/v/pairit?color=7C3AED&label=PyPI&style=flat-square" alt="PyPI version"/></a>
+  <a href="https://pypi.org/project/pairit/"><img src="https://img.shields.io/pypi/pyversions/pairit?color=EA580C&style=flat-square" alt="Python versions"/></a>
+  <img src="https://img.shields.io/badge/Chrome%20Extension-MV3-4285F4?style=flat-square&logo=googlechrome&logoColor=white" alt="Chrome MV3"/>
+  <img src="https://img.shields.io/badge/license-MIT-22C55E?style=flat-square" alt="License MIT"/>
+</p>
+
+---
+
+## What is pAIrit?
+
+**pAIrit** is a developer-focused bridge that lets a local Python application talk to AI services — **ChatGPT, Claude, and Gemini** — through the browser tabs you already have open. No API keys, no separate billing; your Python code sends a request, pAIrit routes it to the right browser tab, and streams the answer back.
+
+> **Note:** pAIrit is intended for local development workflows where the developer is already authenticated with the AI services in their browser.
+
+---
+
+## How It Works
+
+```
+Your Python Application
+        │
+        ▼
+    pairit SDK  (pip install pairit)
+        │
+        │  WebSocket
+        ▼
+  Local pairit Bridge
+        │
+        │  Persistent connection
+        ▼
+  PairIt Chrome Extension
+    ┌────┴────┬───────┐
+    ▼         ▼       ▼
+ ChatGPT   Claude   Gemini
+  (tab)    (tab)    (tab)
+```
+
+**Design highlights:**
+
+- Your app opens **one** WebSocket connection to the bridge — not a separate connection per provider.
+- The extension locates a provider tab only when a request for that provider arrives.
+- If the required tab is missing, PairIt returns a clear error:
+  `Claude is not open. Open Claude in a Chrome tab and try again.`
+
+---
+
+## Features
+
+| Feature | Details |
+|---|---|
+| 🔄 **Multi-provider** | ChatGPT, Claude, Gemini — switch with one line |
+| 📡 **Streaming** | Real-time browser-side streaming via DOM observer |
+| 🔐 **No API keys** | Uses your existing logged-in browser sessions |
+| 🪟 **Minimized Chrome** | Bridge stays alive even when Chrome is hidden |
+| 🐍 **Python ≥ 3.10** | Async-first, built on `aiohttp` |
+| 🧩 **Chrome MV3** | Modern Manifest V3 extension |
+
+---
+
+## Installation
+
+### 1. Install the Python package
+
+```bash
+pip install pairit
+```
+
+### 2. Load the Chrome extension
+
+The easiest option is to install PairIt directly from the [Chrome Web Store](https://chromewebstore.google.com/detail/pair/pkcgibncheoddhpfieekkjdffpmmenie).
+
+1. Open the [Chrome Web Store listing](https://chromewebstore.google.com/detail/pair/pkcgibncheoddhpfieekkjdffpmmenie).
+2. Click **Add to Chrome** and confirm the installation.
+3. Pin the **PairIt** extension to your toolbar.
+
+---
+
+## Quick Start
+
+### Basic request
+
+```python
+from pairit import Client
+
+client = Client(provider="chatgpt")
+
+try:
+    response = client.chat("Explain async programming in Python")
+    print(response.content)
+finally:
+    client.close()
+```
+
+### Streaming
+
+```python
+from pairit import Client
+
+client = Client(provider="chatgpt")
+
+try:
+    for chunk in client.chat("Explain Retrieval-Augmented Generation", stream=True):
+        print(chunk.content, end="", flush=True)
+    print()
+finally:
+    client.close()
+```
+
+> `stream=False` (default) returns the full response after generation completes.
+
+---
+
+## Developer Workflow
+
+1. **Run** your Python script — the bridge starts automatically.
+2. **Open** the required AI provider tabs in Chrome and stay logged in.
+3. **Open** the PairIt extension popup and toggle it **ON**.
+4. PairIt continuously attempts to connect to the bridge while the toggle is on.
+5. **Send** requests from your code — pairit handles routing.
+6. When finished, toggle the extension **OFF**.
+
+> The extension does **not** auto-enable on a new Chrome session. You must turn it on manually to keep control explicit.
+
+---
+
+## Status Model
+
+PairIt tracks two independent states:
+
+| State | Description |
+|---|---|
+| **Bridge connection** | Local Python app ↔ Chrome extension (WebSocket) |
+| **Provider availability** | Whether a ChatGPT / Claude / Gemini tab is currently open |
+
+A provider does **not** need to be permanently connected — it only needs to be open at the moment a request targets it.
+
+---
+
+## Safety & Scope
+
+pAIrit is a development-only tool. It **does not**:
+
+- ❌ Extract or store cookies
+- ❌ Bypass authentication
+- ❌ Circumvent anti-bot protections
+- ❌ Automatically switch providers to evade rate limits
+
+---
+
+## Requirements
+
+- Python **≥ 3.10**
+- Google Chrome (with the PairIt extension loaded)
+- Active browser sessions for the AI providers you intend to use
+
+---
+
+## Contributing
+
+Contributions are welcome! For substantial changes, please open an issue first to discuss the proposed modification.
+
+---
+
+<p align="center">
+  Made with ❤️ by pAIrit contributors
+</p>

pairit-0.4.0/pair/__init__.py

@@ -0,0 +1,26 @@
+"""Backward compatibility alias for pairit."""
+from pairit import (
+    BridgeNotRunningError,
+    ChatChunk,
+    ChatResponse,
+    ChatTimeoutError,
+    Client,
+    ExtensionNotConnectedError,
+    PairError,
+    PairitError,
+    ProviderError,
+    ProviderNotOpenError,
+)
+
+__all__ = [
+    "Client",
+    "ChatChunk",
+    "ChatResponse",
+    "PairitError",
+    "PairError",
+    "BridgeNotRunningError",
+    "ExtensionNotConnectedError",
+    "ProviderNotOpenError",
+    "ProviderError",
+    "ChatTimeoutError",
+]