tokenguard-local 0.1.0__tar.gz

tokenguard_local-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+
+MIT License
+
+Copyright (c) 2026 TokenGuard Contributors
+
+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.

tokenguard_local-0.1.0/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: tokenguard-local
+Version: 0.1.0
+Summary: Lightweight local request protection for Python AI applications
+Author: TokenGuard Contributors
+License-Expression: MIT
+Keywords: ai,llm,token-budget,loop-detection,python
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+
+# TokenGuard 🛡️
+
+**Lightweight local request protection for Python AI applications.**
+
+TokenGuard helps developers limit oversized prompts and detect repeated requests within a configurable time window.
+
+## Features
+
+- **Prompt size limits** — Reject prompts that exceed the configured token estimate.
+- **Repeated request detection** — Block identical prompts after a configurable number of previous requests.
+- **Time-window tracking** — Expire old request records automatically.
+- **Thread safety** — Protect shared request history with a lock.
+- **Input validation** — Reject invalid prompt types and configuration values.
+- **No external dependencies** — Uses Python's standard library.
+
+## Requirements
+
+- Python 3.9 or newer recommended.
+- No third-party packages required.
+
+## Installation
+
+Clone the repository:
+
+```bash
+git clone https://github.com/mokhabelet habang4-cpu/token-guard.git
+```
+
+Enter the project directory:
+
+```bash
+cd token-guard
+```
+
+> If your GitHub username or repository URL differs, replace the URL with your repository's actual clone URL.
+
+## Usage
+
+```python
+from token_guard import TokenGuard
+
+guard = TokenGuard(
+    max_tokens=8000,
+    max_repeats=3,
+    window_seconds=60,
+)
+
+prompt = "Explain how AI works."
+
+if guard.check(prompt):
+    print("Request allowed")
+else:
+    print("Request blocked")
+```
+
+## Configuration
+
+| Parameter | Default | Description |
+|---|---:|---|
+| `max_tokens` | `8000` | Maximum estimated prompt tokens |
+| `max_repeats` | `3` | Maximum number of previously accepted identical prompts |
+| `window_seconds` | `60` | Time window used for request tracking |
+
+The repeat limit counts previous matching requests. A prompt is blocked when the number of earlier matching requests in the active window reaches `max_repeats`.
+
+## Token estimation
+
+TokenGuard estimates token usage using prompt length:
+
+```python
+estimated_tokens = max(1, (len(text) + 3) // 4)
+```
+
+This is a rough estimate, not an exact model tokenizer. Actual token counts vary by AI model and text content.
+
+## Run tests
+
+Run the test suite with Python:
+
+```bash
+python -m unittest -v
+```
+
+## Limitations
+
+- Request history is stored in memory and resets when the process restarts.
+- Limits apply to a single `TokenGuard` instance, not automatically across multiple processes or servers.
+- TokenGuard does not contact AI providers or validate their actual token usage.
+- Applications must call `guard.check(prompt)` before sending a request to their AI provider.
+- This package does not replace authentication, authorization, or provider-side rate limits.
+
+## Project status
+
+TokenGuard is an early-stage project focused on lightweight, local request protection for Python AI applications.
+
+## License
+
+See the repository's license file for usage and distribution terms.

tokenguard_local-0.1.0/README.md

@@ -0,0 +1,99 @@
+
+# TokenGuard 🛡️
+
+**Lightweight local request protection for Python AI applications.**
+
+TokenGuard helps developers limit oversized prompts and detect repeated requests within a configurable time window.
+
+## Features
+
+- **Prompt size limits** — Reject prompts that exceed the configured token estimate.
+- **Repeated request detection** — Block identical prompts after a configurable number of previous requests.
+- **Time-window tracking** — Expire old request records automatically.
+- **Thread safety** — Protect shared request history with a lock.
+- **Input validation** — Reject invalid prompt types and configuration values.
+- **No external dependencies** — Uses Python's standard library.
+
+## Requirements
+
+- Python 3.9 or newer recommended.
+- No third-party packages required.
+
+## Installation
+
+Clone the repository:
+
+```bash
+git clone https://github.com/mokhabelet habang4-cpu/token-guard.git
+```
+
+Enter the project directory:
+
+```bash
+cd token-guard
+```
+
+> If your GitHub username or repository URL differs, replace the URL with your repository's actual clone URL.
+
+## Usage
+
+```python
+from token_guard import TokenGuard
+
+guard = TokenGuard(
+    max_tokens=8000,
+    max_repeats=3,
+    window_seconds=60,
+)
+
+prompt = "Explain how AI works."
+
+if guard.check(prompt):
+    print("Request allowed")
+else:
+    print("Request blocked")
+```
+
+## Configuration
+
+| Parameter | Default | Description |
+|---|---:|---|
+| `max_tokens` | `8000` | Maximum estimated prompt tokens |
+| `max_repeats` | `3` | Maximum number of previously accepted identical prompts |
+| `window_seconds` | `60` | Time window used for request tracking |
+
+The repeat limit counts previous matching requests. A prompt is blocked when the number of earlier matching requests in the active window reaches `max_repeats`.
+
+## Token estimation
+
+TokenGuard estimates token usage using prompt length:
+
+```python
+estimated_tokens = max(1, (len(text) + 3) // 4)
+```
+
+This is a rough estimate, not an exact model tokenizer. Actual token counts vary by AI model and text content.
+
+## Run tests
+
+Run the test suite with Python:
+
+```bash
+python -m unittest -v
+```
+
+## Limitations
+
+- Request history is stored in memory and resets when the process restarts.
+- Limits apply to a single `TokenGuard` instance, not automatically across multiple processes or servers.
+- TokenGuard does not contact AI providers or validate their actual token usage.
+- Applications must call `guard.check(prompt)` before sending a request to their AI provider.
+- This package does not replace authentication, authorization, or provider-side rate limits.
+
+## Project status
+
+TokenGuard is an early-stage project focused on lightweight, local request protection for Python AI applications.
+
+## License
+
+See the repository's license file for usage and distribution terms.

tokenguard_local-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tokenguard-local"
+version = "0.1.0"
+description = "Lightweight local request protection for Python AI applications"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "TokenGuard Contributors" }
+]
+keywords = [
+    "ai",
+    "llm",
+    "token-budget",
+    "loop-detection",
+    "python"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent"
+]
+
+[tool.setuptools]
+py-modules = ["token_guard"]

tokenguard_local-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tokenguard_local-0.1.0/token_guard.py

@@ -0,0 +1,74 @@
+
+"""TokenGuard: lightweight local request protection for Python AI apps."""
+
+from collections import deque
+from hashlib import sha256
+from threading import Lock
+import time
+
+
+class TokenGuard:
+    """Block oversized prompts and repeated requests within a time window."""
+
+    def __init__(
+        self,
+        max_tokens=8000,
+        max_repeats=3,
+        window_seconds=60,
+    ):
+        if max_tokens < 1:
+            raise ValueError("max_tokens must be at least 1")
+        if max_repeats < 1:
+            raise ValueError("max_repeats must be at least 1")
+        if window_seconds <= 0:
+            raise ValueError("window_seconds must be positive")
+
+        self.max_tokens = max_tokens
+        self.max_repeats = max_repeats
+        self.window_seconds = window_seconds
+        self.history = deque()
+        self.lock = Lock()
+
+    @staticmethod
+    def estimate_tokens(text):
+        """Estimate tokens quickly; this is not an exact tokenizer."""
+        if not isinstance(text, str):
+            raise TypeError("prompt must be a string")
+
+        return max(1, (len(text) + 3) // 4)
+
+    def check(self, prompt):
+        """Return True if allowed, or False if blocked."""
+        if not isinstance(prompt, str):
+            raise TypeError("prompt must be a string")
+
+        if self.estimate_tokens(prompt) > self.max_tokens:
+            return False
+
+        now = time.monotonic()
+        fingerprint = sha256(prompt.encode("utf-8")).hexdigest()
+
+        with self.lock:
+            # Remove requests outside the active time window.
+            while (
+                self.history
+                and now - self.history[0][0] >= self.window_seconds
+            ):
+                self.history.popleft()
+
+            # Count earlier matching requests in this window.
+            repeats = sum(
+                1
+                for _, previous in self.history
+                if previous == fingerprint
+            )
+
+            if repeats >= self.max_repeats:
+                return False
+
+            self.history.append((now, fingerprint))
+            return True
+
+
+# Ready-to-use default guard.
+guard = TokenGuard()

tokenguard_local-0.1.0/tokenguard_local.egg-info/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: tokenguard-local
+Version: 0.1.0
+Summary: Lightweight local request protection for Python AI applications
+Author: TokenGuard Contributors
+License-Expression: MIT
+Keywords: ai,llm,token-budget,loop-detection,python
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+
+# TokenGuard 🛡️
+
+**Lightweight local request protection for Python AI applications.**
+
+TokenGuard helps developers limit oversized prompts and detect repeated requests within a configurable time window.
+
+## Features
+
+- **Prompt size limits** — Reject prompts that exceed the configured token estimate.
+- **Repeated request detection** — Block identical prompts after a configurable number of previous requests.
+- **Time-window tracking** — Expire old request records automatically.
+- **Thread safety** — Protect shared request history with a lock.
+- **Input validation** — Reject invalid prompt types and configuration values.
+- **No external dependencies** — Uses Python's standard library.
+
+## Requirements
+
+- Python 3.9 or newer recommended.
+- No third-party packages required.
+
+## Installation
+
+Clone the repository:
+
+```bash
+git clone https://github.com/mokhabelet habang4-cpu/token-guard.git
+```
+
+Enter the project directory:
+
+```bash
+cd token-guard
+```
+
+> If your GitHub username or repository URL differs, replace the URL with your repository's actual clone URL.
+
+## Usage
+
+```python
+from token_guard import TokenGuard
+
+guard = TokenGuard(
+    max_tokens=8000,
+    max_repeats=3,
+    window_seconds=60,
+)
+
+prompt = "Explain how AI works."
+
+if guard.check(prompt):
+    print("Request allowed")
+else:
+    print("Request blocked")
+```
+
+## Configuration
+
+| Parameter | Default | Description |
+|---|---:|---|
+| `max_tokens` | `8000` | Maximum estimated prompt tokens |
+| `max_repeats` | `3` | Maximum number of previously accepted identical prompts |
+| `window_seconds` | `60` | Time window used for request tracking |
+
+The repeat limit counts previous matching requests. A prompt is blocked when the number of earlier matching requests in the active window reaches `max_repeats`.
+
+## Token estimation
+
+TokenGuard estimates token usage using prompt length:
+
+```python
+estimated_tokens = max(1, (len(text) + 3) // 4)
+```
+
+This is a rough estimate, not an exact model tokenizer. Actual token counts vary by AI model and text content.
+
+## Run tests
+
+Run the test suite with Python:
+
+```bash
+python -m unittest -v
+```
+
+## Limitations
+
+- Request history is stored in memory and resets when the process restarts.
+- Limits apply to a single `TokenGuard` instance, not automatically across multiple processes or servers.
+- TokenGuard does not contact AI providers or validate their actual token usage.
+- Applications must call `guard.check(prompt)` before sending a request to their AI provider.
+- This package does not replace authentication, authorization, or provider-side rate limits.
+
+## Project status
+
+TokenGuard is an early-stage project focused on lightweight, local request protection for Python AI applications.
+
+## License
+
+See the repository's license file for usage and distribution terms.

tokenguard_local-0.1.0/tokenguard_local.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+token_guard.py
+tokenguard_local.egg-info/PKG-INFO
+tokenguard_local.egg-info/SOURCES.txt
+tokenguard_local.egg-info/dependency_links.txt
+tokenguard_local.egg-info/top_level.txt

tokenguard_local-0.1.0/tokenguard_local.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tokenguard_local-0.1.0/tokenguard_local.egg-info/top_level.txt

@@ -0,0 +1 @@
+token_guard