langchain-githubcopilot-chat 0.2.0__tar.gz → 0.3.0__tar.gz

langchain_githubcopilot_chat-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 YIhan Wu
+
+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.

langchain_githubcopilot_chat-0.3.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.1
+Name: langchain-githubcopilot-chat
+Version: 0.3.0
+Summary: An integration package connecting GithubcopilotChat and LangChain
+Home-page: https://github.com/langchain-ai/langchain
+License: MIT
+Author: YIhan Wu
+Author-email: iumm@ibat.ac.cn
+Requires-Python: >=3.10,<4.0
+Classifier: License :: OSI Approved :: MIT License
+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
+Requires-Dist: httpx (>=0.28.1)
+Requires-Dist: langchain-core (>=1.1.0,<2.0.0)
+Project-URL: Repository, https://github.com/langchain-ai/langchain
+Project-URL: Release Notes, https://github.com/langchain-ai/langchain/releases?q=tag%3A%22githubcopilot-chat%3D%3D0%22&expanded=true
+Project-URL: Source Code, https://github.com/langchain-ai/langchain/tree/master/libs/partners/githubcopilot-chat
+Description-Content-Type: text/markdown
+
+# LangChain GitHub Copilot Chat
+
+This package provides a LangChain integration for **GitHub Copilot**, allowing you to use Copilot's models (including GPT-4o, Claude 3.5 Sonnet, etc.) as standard LangChain `BaseChatModel` components.
+
+Unlike other integrations, this package mimics the official VS Code Copilot Chat extension behavior, providing access to the full suite of models available to Copilot subscribers.
+
+## 🚀 Features
+
+- **Real Copilot API**: Connects to `api.githubcopilot.com` using official VS Code headers.
+- **Easy Auth**: Built-in GitHub Device Flow for acquiring a valid Copilot Token.
+- **Model Discovery**: Dynamic fetching of all models authorized for your account.
+- **LangChain Native**: Full support for Streaming, Tool Calling, and Async operations.
+
+## 📦 Installation
+
+```bash
+pip install -U langchain-githubcopilot-chat
+```
+
+## 🔐 Authentication
+
+To use GitHub Copilot, you need a valid Copilot Token. You can obtain one interactively using the built-in helper:
+
+```python
+from langchain_githubcopilot_chat import get_vscode_token
+
+# This will prompt you to visit a GitHub URL and enter a code
+token = get_vscode_token()
+print(f"Your Token: {token}")
+```
+
+For custom output handling (e.g., in GUI applications), pass a callback:
+
+```python
+from langchain_githubcopilot_chat import get_copilot_token
+
+def on_message(msg):
+    # Handle status messages (e.g., display in UI)
+    print(f"[Copilot] {msg}")
+
+token = get_vscode_token(callback=on_message)
+```
+
+Alternatively, set it as an environment variable:
+```bash
+export GITHUB_TOKEN="your_copilot_token_here"
+```
+
+## 🛠 Usage
+
+### Chat Models
+
+Access any model supported by Copilot (e.g., `gpt-4o`, `gpt-4o-mini`, `claude-3.5-sonnet`).
+
+```python
+from langchain_githubcopilot_chat import ChatGithubCopilot
+
+# Initialize with a specific model
+llm = ChatGithubCopilot(
+    model="gpt-4o", 
+    temperature=0.7
+)
+
+# Simple invocation
+response = llm.invoke("Explain Quantum Entanglement in one sentence.")
+print(response.content)
+
+# Streaming
+for chunk in llm.stream("Write a short poem about coding."):
+    print(chunk.content, end="", flush=True)
+```
+
+### Discovery Available Models
+
+GitHub Copilot periodically updates its available models. You can list what's currently available for your token:
+
+```python
+from langchain_githubcopilot_chat import get_available_models
+
+models = get_available_models()
+for model in models:
+    print(f"ID: {model['id']} - Name: {model.get('name')}")
+```
+
+### Embeddings
+
+Use Copilot's embedding models for RAG or semantic search:
+
+```python
+from langchain_githubcopilot_chat import GithubcopilotChatEmbeddings
+
+embeddings = GithubcopilotChatEmbeddings(model="text-embedding-3-small")
+vector = embeddings.embed_query("GitHub Copilot is awesome!")
+```
+
+## 📖 Advanced: Tool Calling
+
+```python
+from pydantic import BaseModel, Field
+from langchain_githubcopilot_chat import ChatGithubCopilot
+
+class GetWeather(BaseModel):
+    """Get the current weather in a given location."""
+    location: str = Field(..., description="The city and state, e.g. San Francisco, CA")
+
+llm = ChatGithubCopilot(model="gpt-4o")
+llm_with_tools = llm.bind_tools([GetWeather])
+
+ai_msg = llm_with_tools.invoke("What's the weather like in Tokyo?")
+print(ai_msg.tool_calls)
+```
+
+## ⚖️ Disclaimer
+
+This project is an independent community integration and is not affiliated with, endorsed by, or supported by GitHub, Inc. Usage of this package must comply with GitHub's [Terms of Service](https://docs.github.com/en/site-policy/github-terms/github-terms-of-service).

langchain_githubcopilot_chat-0.3.0/README.md

@@ -0,0 +1,115 @@
+# LangChain GitHub Copilot Chat
+
+This package provides a LangChain integration for **GitHub Copilot**, allowing you to use Copilot's models (including GPT-4o, Claude 3.5 Sonnet, etc.) as standard LangChain `BaseChatModel` components.
+
+Unlike other integrations, this package mimics the official VS Code Copilot Chat extension behavior, providing access to the full suite of models available to Copilot subscribers.
+
+## 🚀 Features
+
+- **Real Copilot API**: Connects to `api.githubcopilot.com` using official VS Code headers.
+- **Easy Auth**: Built-in GitHub Device Flow for acquiring a valid Copilot Token.
+- **Model Discovery**: Dynamic fetching of all models authorized for your account.
+- **LangChain Native**: Full support for Streaming, Tool Calling, and Async operations.
+
+## 📦 Installation
+
+```bash
+pip install -U langchain-githubcopilot-chat
+```
+
+## 🔐 Authentication
+
+To use GitHub Copilot, you need a valid Copilot Token. You can obtain one interactively using the built-in helper:
+
+```python
+from langchain_githubcopilot_chat import get_vscode_token
+
+# This will prompt you to visit a GitHub URL and enter a code
+token = get_vscode_token()
+print(f"Your Token: {token}")
+```
+
+For custom output handling (e.g., in GUI applications), pass a callback:
+
+```python
+from langchain_githubcopilot_chat import get_copilot_token
+
+def on_message(msg):
+    # Handle status messages (e.g., display in UI)
+    print(f"[Copilot] {msg}")
+
+token = get_vscode_token(callback=on_message)
+```
+
+Alternatively, set it as an environment variable:
+```bash
+export GITHUB_TOKEN="your_copilot_token_here"
+```
+
+## 🛠 Usage
+
+### Chat Models
+
+Access any model supported by Copilot (e.g., `gpt-4o`, `gpt-4o-mini`, `claude-3.5-sonnet`).
+
+```python
+from langchain_githubcopilot_chat import ChatGithubCopilot
+
+# Initialize with a specific model
+llm = ChatGithubCopilot(
+    model="gpt-4o", 
+    temperature=0.7
+)
+
+# Simple invocation
+response = llm.invoke("Explain Quantum Entanglement in one sentence.")
+print(response.content)
+
+# Streaming
+for chunk in llm.stream("Write a short poem about coding."):
+    print(chunk.content, end="", flush=True)
+```
+
+### Discovery Available Models
+
+GitHub Copilot periodically updates its available models. You can list what's currently available for your token:
+
+```python
+from langchain_githubcopilot_chat import get_available_models
+
+models = get_available_models()
+for model in models:
+    print(f"ID: {model['id']} - Name: {model.get('name')}")
+```
+
+### Embeddings
+
+Use Copilot's embedding models for RAG or semantic search:
+
+```python
+from langchain_githubcopilot_chat import GithubcopilotChatEmbeddings
+
+embeddings = GithubcopilotChatEmbeddings(model="text-embedding-3-small")
+vector = embeddings.embed_query("GitHub Copilot is awesome!")
+```
+
+## 📖 Advanced: Tool Calling
+
+```python
+from pydantic import BaseModel, Field
+from langchain_githubcopilot_chat import ChatGithubCopilot
+
+class GetWeather(BaseModel):
+    """Get the current weather in a given location."""
+    location: str = Field(..., description="The city and state, e.g. San Francisco, CA")
+
+llm = ChatGithubCopilot(model="gpt-4o")
+llm_with_tools = llm.bind_tools([GetWeather])
+
+ai_msg = llm_with_tools.invoke("What's the weather like in Tokyo?")
+print(ai_msg.tool_calls)
+```
+
+## ⚖️ Disclaimer
+
+This project is an independent community integration and is not affiliated with, endorsed by, or supported by GitHub, Inc. Usage of this package must comply with GitHub's [Terms of Service](https://docs.github.com/en/site-policy/github-terms/github-terms-of-service).

{langchain_githubcopilot_chat-0.2.0 → langchain_githubcopilot_chat-0.3.0}/langchain_githubcopilot_chat/auth.py

@@ -1,12 +1,14 @@
 import time
-from typing import Optional
+from typing import Callable, Optional
 
 import httpx
 
 CLIENT_ID = "Iv1.b507a08c87ecfe98"
 
 
-def get_copilot_token(client_id: str = CLIENT_ID) -> Optional[str]:
+def get_copilot_token(
+    client_id: str = CLIENT_ID, callback: Optional[Callable[[str], None]] = None
+) -> Optional[str]:
     """
     Authenticate via GitHub Device Flow to get a Copilot Token.
     This function will block and wait for the user to complete the
@@ -15,11 +17,20 @@ def get_copilot_token(client_id: str = CLIENT_ID) -> Optional[str]:
     Args:
         client_id: The GitHub OAuth App Client ID to use. Defaults
             to the VS Code Copilot Chat client ID.
+        callback: Optional callable that receives status messages instead of
+            printing them. If None, messages are printed to stdout.
 
     Returns:
         The fetched Copilot Token string, or None if authentication failed.
     """
-    print("1. Requesting device code from GitHub...")  # noqa: T201  # noqa: T201
+
+    def _print(msg: str) -> None:
+        if callback:
+            callback(msg)
+        else:
+            print(msg)  # noqa: T201
+
+    _print("1. Requesting device code from GitHub...")
     with httpx.Client() as client:
         res = client.post(
             "https://github.com/login/device/code",
@@ -34,11 +45,11 @@ def get_copilot_token(client_id: str = CLIENT_ID) -> Optional[str]:
     verification_uri = data.get("verification_uri")
     interval = data.get("interval", 5)
 
-    print("\n==========================================")  # noqa: T201
-    print(f"Please open your browser to: {verification_uri}")  # noqa: T201
-    print(f"And enter the authorization code: {user_code}")  # noqa: T201
-    print("==========================================\n")  # noqa: T201
-    print(f"Waiting for authorization (checking every {interval} seconds)...")  # noqa: T201
+    _print("\n==========================================")
+    _print(f"Please open your browser to: {verification_uri}")
+    _print(f"And enter the authorization code: {user_code}")
+    _print("==========================================\n")
+    _print(f"Waiting for authorization (checking every {interval} seconds)...")
 
     access_token = None
     with httpx.Client() as client:
@@ -55,14 +66,14 @@ def get_copilot_token(client_id: str = CLIENT_ID) -> Optional[str]:
 
             if "access_token" in token_res:
                 access_token = token_res["access_token"]
-                print(  # noqa: T201  # noqa: T201
+                _print(
                     "\n✅ Authorization successful! Exchanging for Copilot Token..."
                 )
                 break
             elif token_res.get("error") == "authorization_pending":
                 time.sleep(interval)
             else:
-                print(f"\n❌ Authorization failed: {token_res}")  # noqa: T201  # noqa: T201
+                _print(f"\n❌ Authorization failed: {token_res}")
                 return None
 
         # Exchange the standard access token for a Copilot internal token
@@ -78,8 +89,8 @@ def get_copilot_token(client_id: str = CLIENT_ID) -> Optional[str]:
 
         if copilot_res.status_code == 200:
             copilot_token = copilot_res.json().get("token")
-            print("🎉 Successfully acquired Copilot Token!")  # noqa: T201  # noqa: T201
+            _print("🎉 Successfully acquired Copilot Token!")
             return copilot_token
         else:
-            print(f"❌ Failed to acquire Copilot Token: {copilot_res.text}")  # noqa: T201  # noqa: T201
+            _print(f"❌ Failed to acquire Copilot Token: {copilot_res.text}")
             return None

{langchain_githubcopilot_chat-0.2.0 → langchain_githubcopilot_chat-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "langchain-githubcopilot-chat"
-version = "0.2.0"
+version = "0.3.0"
 description = "An integration package connecting GithubcopilotChat and LangChain"
 authors = ["YIhan Wu <iumm@ibat.ac.cn>"]
 readme = "README.md"

langchain_githubcopilot_chat-0.2.0/PKG-INFO

@@ -1,69 +0,0 @@
-Metadata-Version: 2.1
-Name: langchain-githubcopilot-chat
-Version: 0.2.0
-Summary: An integration package connecting GithubcopilotChat and LangChain
-Home-page: https://github.com/langchain-ai/langchain
-License: MIT
-Author: YIhan Wu
-Author-email: iumm@ibat.ac.cn
-Requires-Python: >=3.10,<4.0
-Classifier: License :: OSI Approved :: MIT License
-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
-Requires-Dist: httpx (>=0.28.1)
-Requires-Dist: langchain-core (>=1.1.0,<2.0.0)
-Project-URL: Repository, https://github.com/langchain-ai/langchain
-Project-URL: Release Notes, https://github.com/langchain-ai/langchain/releases?q=tag%3A%22githubcopilot-chat%3D%3D0%22&expanded=true
-Project-URL: Source Code, https://github.com/langchain-ai/langchain/tree/master/libs/partners/githubcopilot-chat
-Description-Content-Type: text/markdown
-
-# langchain-githubcopilot-chat
-
-This package contains the LangChain integration with GithubcopilotChat
-
-## Installation
-
-```bash
-pip install -U langchain-githubcopilot-chat
-```
-
-And you should configure credentials by setting the following environment variables:
-
-* TODO: fill this out
-
-## Chat Models
-
-`ChatGithubcopilotChat` class exposes chat models from GithubcopilotChat.
-
-```python
-from langchain_githubcopilot_chat import ChatGithubcopilotChat
-
-llm = ChatGithubcopilotChat()
-llm.invoke("Sing a ballad of LangChain.")
-```
-
-## Embeddings
-
-`GithubcopilotChatEmbeddings` class exposes embeddings from GithubcopilotChat.
-
-```python
-from langchain_githubcopilot_chat import GithubcopilotChatEmbeddings
-
-embeddings = GithubcopilotChatEmbeddings()
-embeddings.embed_query("What is the meaning of life?")
-```
-
-## LLMs
-
-`GithubcopilotChatLLM` class exposes LLMs from GithubcopilotChat.
-
-```python
-from langchain_githubcopilot_chat import GithubcopilotChatLLM
-
-llm = GithubcopilotChatLLM()
-llm.invoke("The meaning of life is")
-```
-

langchain_githubcopilot_chat-0.2.0/README.md

@@ -1,46 +0,0 @@
-# langchain-githubcopilot-chat
-
-This package contains the LangChain integration with GithubcopilotChat
-
-## Installation
-
-```bash
-pip install -U langchain-githubcopilot-chat
-```
-
-And you should configure credentials by setting the following environment variables:
-
-* TODO: fill this out
-
-## Chat Models
-
-`ChatGithubcopilotChat` class exposes chat models from GithubcopilotChat.
-
-```python
-from langchain_githubcopilot_chat import ChatGithubcopilotChat
-
-llm = ChatGithubcopilotChat()
-llm.invoke("Sing a ballad of LangChain.")
-```
-
-## Embeddings
-
-`GithubcopilotChatEmbeddings` class exposes embeddings from GithubcopilotChat.
-
-```python
-from langchain_githubcopilot_chat import GithubcopilotChatEmbeddings
-
-embeddings = GithubcopilotChatEmbeddings()
-embeddings.embed_query("What is the meaning of life?")
-```
-
-## LLMs
-
-`GithubcopilotChatLLM` class exposes LLMs from GithubcopilotChat.
-
-```python
-from langchain_githubcopilot_chat import GithubcopilotChatLLM
-
-llm = GithubcopilotChatLLM()
-llm.invoke("The meaning of life is")
-```