pnotp 0.1.0__tar.gz

pnotp-0.1.0/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: pnotp
+Version: 0.1.0
+Summary: PnotP client and API wrappers for PathoVision models.
+Project-URL: Homepage, https://pnotp.ai
+Author-email: PnotP <support@pnotp.ai>
+Requires-Python: >=3.9
+Requires-Dist: httpx<0.29,>=0.24
+Provides-Extra: server
+Requires-Dist: fastapi<1.0,>=0.110; extra == 'server'
+Requires-Dist: pillow>=9.0; extra == 'server'
+Requires-Dist: pydantic<3.0,>=2.0; extra == 'server'
+Requires-Dist: python-multipart>=0.0.6; extra == 'server'
+Requires-Dist: uvicorn<0.29,>=0.23; extra == 'server'
+Description-Content-Type: text/markdown
+
+# PnotP
+
+Unified API and Python client for PathoVision vision models.
+
+## Packages
+- `pnotp_api`: FastAPI service that wraps PathoVision ensembles under a consistent `/v1` surface with API-key auth.
+- `pnotp`: Python client for calling the PnotP API.
+
+## Install (client only)
+```bash
+pip install pnotp
+```
+
+## Install (client + server extra)
+```bash
+pip install "pnotp[server]"
+```
+
+## Usage (client)
+```python
+import pnotp as pnp
+
+client = pnp.client(api_key="YOUR_KEY")  # default base URL is production
+client.models()
+model = client.models("pneumonia_binary_classification")
+result = model.predict("image.jpg")
+heatmap = model.attention_map("image.jpg")
+```
+
+Set your key once per shell:
+```bash
+export PNOTP_API_KEY="your_api_key_here"
+python your_script.py  # pnp.client() will read the env var automatically
+```
+
+## Run the API locally
+```bash
+export PNOTP_INTERNAL_SECRET="dev-secret"
+export PATHOVISION_ROOT="/absolute/path/to/PathoVision"  # if not default
+uvicorn pnotp_api.main:app --host 0.0.0.0 --port 8000
+```
+
+## Issue an API key (internal)
+```bash
+curl -X POST http://127.0.0.1:8000/internal/api-keys \
+  -H "X-Internal-Secret: $PNOTP_INTERNAL_SECRET" \
+  -H "Content-Type: application/json" \
+  -d '{"user_external_id":"demo-user","plan_code":"pathovision_starter"}'
+```

pnotp-0.1.0/README.md

@@ -0,0 +1,49 @@
+# PnotP
+
+Unified API and Python client for PathoVision vision models.
+
+## Packages
+- `pnotp_api`: FastAPI service that wraps PathoVision ensembles under a consistent `/v1` surface with API-key auth.
+- `pnotp`: Python client for calling the PnotP API.
+
+## Install (client only)
+```bash
+pip install pnotp
+```
+
+## Install (client + server extra)
+```bash
+pip install "pnotp[server]"
+```
+
+## Usage (client)
+```python
+import pnotp as pnp
+
+client = pnp.client(api_key="YOUR_KEY")  # default base URL is production
+client.models()
+model = client.models("pneumonia_binary_classification")
+result = model.predict("image.jpg")
+heatmap = model.attention_map("image.jpg")
+```
+
+Set your key once per shell:
+```bash
+export PNOTP_API_KEY="your_api_key_here"
+python your_script.py  # pnp.client() will read the env var automatically
+```
+
+## Run the API locally
+```bash
+export PNOTP_INTERNAL_SECRET="dev-secret"
+export PATHOVISION_ROOT="/absolute/path/to/PathoVision"  # if not default
+uvicorn pnotp_api.main:app --host 0.0.0.0 --port 8000
+```
+
+## Issue an API key (internal)
+```bash
+curl -X POST http://127.0.0.1:8000/internal/api-keys \
+  -H "X-Internal-Secret: $PNOTP_INTERNAL_SECRET" \
+  -H "Content-Type: application/json" \
+  -d '{"user_external_id":"demo-user","plan_code":"pathovision_starter"}'
+```

pnotp-0.1.0/plat/exports/CONSTRUCTION-GUIDE.md

@@ -0,0 +1,226 @@
+# P¬P Brand Identity Construction Guide
+
+## Monogram Construction
+
+The P¬P monogram is built on a 64×64px viewBox using geometric precision.
+
+### Construction Grid
+```
+ViewBox: 0 0 64 64
+Stroke width: 1.5px
+Stroke linecap: square
+Stroke linejoin: miter
+```
+
+### Element Coordinates
+
+**P Shape (Inverted-L Bracket Skeleton):**
+1. Left vertical stem: (18, 14) → (18, 50)
+2. Top horizontal: (18, 14) → (38, 14)
+3. Right vertical (P bowl): (38, 14) → (38, 32)
+4. Bottom horizontal (P bowl): (38, 32) → (18, 32)
+
+**Negation Mark (¬):**
+1. Horizontal line: (42, 14) → (46, 14)
+2. Vertical line: (42, 14) → (42, 18)
+
+### Visual Representation
+```
+        ¬
+    ┌───────┐
+    │       │
+    │       │ (P bowl)
+    ├───────┘
+    │
+    │ (stem)
+    │
+    │
+    └
+```
+
+---
+
+## Wordmark Construction
+
+**Typography:**
+- Font: Inter Medium (500 weight)
+- Letter spacing: +2% (0.96px at 48px font size)
+- Characters: P¬P (using Unicode ¬ character: U+00AC)
+
+**Specifications:**
+- Font family: Inter, system-ui, sans-serif
+- Font weight: 500
+- Letter spacing: 0.02em
+
+---
+
+## Icon Sizes
+
+All icons use the same viewBox (0 0 64 64) but scale to different display sizes:
+
+- **16×16px** - Favicons, small UI elements
+- **32×32px** - Toolbar icons, small badges
+- **64×64px** - Standard icons, medium usage
+- **128×128px** - Large icons, app icons
+- **256×256px** - High-resolution displays, app stores
+
+---
+
+## Color Variants
+
+### Black Version
+- Stroke: #000000
+- Background: transparent or #FFFFFF
+
+### White Version  
+- Stroke: #FFFFFF
+- Background: #000000
+
+### No other colors permitted
+- Pure monochrome only
+- Optional gray (#C6C6C6) for dividers only, never for logo
+
+---
+
+## Converting to Base64
+
+### Method 1: Command Line
+```bash
+# For macOS/Linux
+base64 -i monogram-black.svg -o monogram-black-base64.txt
+
+# For Windows PowerShell
+[Convert]::ToBase64String([IO.File]::ReadAllBytes("monogram-black.svg"))
+```
+
+### Method 2: Online Tools
+1. Visit: https://base64.guru/converter/encode/image/svg
+2. Upload the SVG file
+3. Copy the Base64 output
+
+### Method 3: JavaScript/Node
+```javascript
+const fs = require('fs');
+const svg = fs.readFileSync('monogram-black.svg', 'utf8');
+const base64 = Buffer.from(svg).toString('base64');
+console.log(base64);
+```
+
+### Usage in HTML/CSS
+```html
+<!-- As img src -->
+<img src="data:image/svg+xml;base64,[YOUR_BASE64_HERE]" alt="P¬P Logo" />
+
+<!-- As CSS background -->
+<style>
+.logo {
+  background-image: url('data:image/svg+xml;base64,[YOUR_BASE64_HERE]');
+}
+</style>
+```
+
+---
+
+## File Inventory
+
+### Monogram Files
+- `monogram-black.svg` - Black stroke, transparent background
+- `monogram-white.svg` - White stroke, transparent background
+
+### Icon Files (All Black)
+- `icon-16.svg` - 16×16px display size
+- `icon-32.svg` - 32×32px display size
+- `icon-64.svg` - 64×64px display size
+- `icon-128.svg` - 128×128px display size
+- `icon-256.svg` - 256×256px display size
+
+### Wordmark Files
+- `wordmark-black.svg` - Black text
+- `wordmark-white.svg` - White text
+
+### Lockup Files
+- `horizontal-lockup-black.svg` - Monogram + wordmark, black
+- `horizontal-lockup-white.svg` - Monogram + wordmark, white
+
+---
+
+## Technical Specifications
+
+### Minimum Clear Space
+- All sides: Equal to the height of the P stem (36px in a 64×64 viewBox)
+- Ratio: Minimum 56% of logo height as clear space
+
+### Minimum Size
+- Digital: 16×16px
+- Print: 0.5 inch (12.7mm)
+
+### Stroke Weight
+- Always: 1.5px at base viewBox
+- Scales proportionally with size
+- Never adjust stroke weight manually
+
+### Export Settings
+- Format: SVG (vector)
+- Additional: PNG at 2400px width minimum for raster needs
+- Color mode: RGB for digital, CMYK for print
+- Background: Transparent
+
+---
+
+## Construction Principles
+
+1. **Geometric Precision**: All coordinates are integers. No sub-pixel positioning.
+2. **Right Angles Only**: No curves, no rounded corners.
+3. **Mathematical Alignment**: Elements align to grid intersections.
+4. **Minimal Strokes**: Constructed from 6 lines total.
+5. **Binary Structure**: P and ¬P represent logical opposition.
+
+---
+
+## Usage Notes
+
+- The negation mark (¬) must always appear in the upper-right
+- Maintain exact proportions when scaling
+- Never distort, rotate, or add effects
+- Use only in black or white—no color variants
+- Preserve stroke width ratio when scaling
+- Export at multiple sizes from the same base vector
+
+---
+
+## Quick Reference: Base Monogram SVG
+
+```xml
+<svg width="64" height="64" viewBox="0 0 64 64" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <g stroke-width="1.5" stroke="#000000" stroke-linecap="square" stroke-linejoin="miter">
+    <line x1="18" y1="14" x2="18" y2="50" />
+    <line x1="18" y1="14" x2="38" y2="14" />
+    <line x1="38" y1="14" x2="38" y2="32" />
+    <line x1="38" y1="32" x2="18" y2="32" />
+    <line x1="42" y1="14" x2="46" y2="14" />
+    <line x1="42" y1="14" x2="42" y2="18" />
+  </g>
+</svg>
+```
+
+To change to white, replace `stroke="#000000"` with `stroke="#FFFFFF"`.
+
+---
+
+## Platform-Specific Exports
+
+### Favicon
+Use `icon-32.svg` or convert to ICO format
+
+### Social Media
+- Twitter/X: 400×400px PNG (export from icon-256.svg)
+- LinkedIn: 300×300px PNG
+- Facebook: 180×180px PNG
+
+### API/SDK
+Use horizontal-lockup for documentation
+Use monogram for API badges and small UI elements
+
+### Presentations
+Use horizontal-lockup-black.svg or horizontal-lockup-white.svg
+Export at 2400px width for high-resolution displays

pnotp-0.1.0/plat/exports/horizontal-lockup-black.svg

@@ -0,0 +1,16 @@
+<svg width="300" height="80" viewBox="0 0 300 80" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- Monogram -->
+  <g transform="translate(20, 8)">
+    <g stroke-width="1.5" stroke="#000000" stroke-linecap="square" stroke-linejoin="miter">
+      <line x1="18" y1="14" x2="18" y2="50" />
+      <line x1="18" y1="14" x2="38" y2="14" />
+      <line x1="38" y1="14" x2="38" y2="32" />
+      <line x1="38" y1="32" x2="18" y2="32" />
+      <line x1="42" y1="14" x2="46" y2="14" />
+      <line x1="42" y1="14" x2="42" y2="18" />
+    </g>
+  </g>
+  
+  <!-- Wordmark -->
+  <text x="120" y="50%" dominant-baseline="middle" font-family="Inter, system-ui, sans-serif" font-size="48" font-weight="500" fill="#000000" letter-spacing="0.96">P¬P</text>
+</svg>

pnotp-0.1.0/plat/exports/horizontal-lockup-white.svg

@@ -0,0 +1,16 @@
+<svg width="300" height="80" viewBox="0 0 300 80" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- Monogram -->
+  <g transform="translate(20, 8)">
+    <g stroke-width="1.5" stroke="#FFFFFF" stroke-linecap="square" stroke-linejoin="miter">
+      <line x1="18" y1="14" x2="18" y2="50" />
+      <line x1="18" y1="14" x2="38" y2="14" />
+      <line x1="38" y1="14" x2="38" y2="32" />
+      <line x1="38" y1="32" x2="18" y2="32" />
+      <line x1="42" y1="14" x2="46" y2="14" />
+      <line x1="42" y1="14" x2="42" y2="18" />
+    </g>
+  </g>
+  
+  <!-- Wordmark -->
+  <text x="120" y="50%" dominant-baseline="middle" font-family="Inter, system-ui, sans-serif" font-size="48" font-weight="500" fill="#FFFFFF" letter-spacing="0.96">P¬P</text>
+</svg>

pnotp-0.1.0/plat/exports/icon-128.svg

@@ -0,0 +1,10 @@
+<svg width="128" height="128" viewBox="0 0 64 64" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <g stroke-width="1.5" stroke="#000000" stroke-linecap="square" stroke-linejoin="miter">
+    <line x1="18" y1="14" x2="18" y2="50" />
+    <line x1="18" y1="14" x2="38" y2="14" />
+    <line x1="38" y1="14" x2="38" y2="32" />
+    <line x1="38" y1="32" x2="18" y2="32" />
+    <line x1="42" y1="14" x2="46" y2="14" />
+    <line x1="42" y1="14" x2="42" y2="18" />
+  </g>
+</svg>

pnotp-0.1.0/plat/exports/icon-16.svg

@@ -0,0 +1,10 @@
+<svg width="16" height="16" viewBox="0 0 64 64" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <g stroke-width="1.5" stroke="#000000" stroke-linecap="square" stroke-linejoin="miter">
+    <line x1="18" y1="14" x2="18" y2="50" />
+    <line x1="18" y1="14" x2="38" y2="14" />
+    <line x1="38" y1="14" x2="38" y2="32" />
+    <line x1="38" y1="32" x2="18" y2="32" />
+    <line x1="42" y1="14" x2="46" y2="14" />
+    <line x1="42" y1="14" x2="42" y2="18" />
+  </g>
+</svg>

pnotp-0.1.0/plat/exports/icon-256.svg

@@ -0,0 +1,10 @@
+<svg width="256" height="256" viewBox="0 0 64 64" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <g stroke-width="1.5" stroke="#000000" stroke-linecap="square" stroke-linejoin="miter">
+    <line x1="18" y1="14" x2="18" y2="50" />
+    <line x1="18" y1="14" x2="38" y2="14" />
+    <line x1="38" y1="14" x2="38" y2="32" />
+    <line x1="38" y1="32" x2="18" y2="32" />
+    <line x1="42" y1="14" x2="46" y2="14" />
+    <line x1="42" y1="14" x2="42" y2="18" />
+  </g>
+</svg>

pnotp-0.1.0/plat/exports/icon-32.svg

@@ -0,0 +1,10 @@
+<svg width="32" height="32" viewBox="0 0 64 64" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <g stroke-width="1.5" stroke="#000000" stroke-linecap="square" stroke-linejoin="miter">
+    <line x1="18" y1="14" x2="18" y2="50" />
+    <line x1="18" y1="14" x2="38" y2="14" />
+    <line x1="38" y1="14" x2="38" y2="32" />
+    <line x1="38" y1="32" x2="18" y2="32" />
+    <line x1="42" y1="14" x2="46" y2="14" />
+    <line x1="42" y1="14" x2="42" y2="18" />
+  </g>
+</svg>

pnotp-0.1.0/plat/exports/icon-64.svg

@@ -0,0 +1,10 @@
+<svg width="64" height="64" viewBox="0 0 64 64" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <g stroke-width="1.5" stroke="#000000" stroke-linecap="square" stroke-linejoin="miter">
+    <line x1="18" y1="14" x2="18" y2="50" />
+    <line x1="18" y1="14" x2="38" y2="14" />
+    <line x1="38" y1="14" x2="38" y2="32" />
+    <line x1="38" y1="32" x2="18" y2="32" />
+    <line x1="42" y1="14" x2="46" y2="14" />
+    <line x1="42" y1="14" x2="42" y2="18" />
+  </g>
+</svg>

pnotp-0.1.0/plat/exports/monogram-black.svg

@@ -0,0 +1,15 @@
+<svg width="64" height="64" viewBox="0 0 64 64" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <g stroke-width="1.5" stroke="#000000" stroke-linecap="square" stroke-linejoin="miter">
+    <!-- Left vertical stem -->
+    <line x1="18" y1="14" x2="18" y2="50" />
+    <!-- Top horizontal -->
+    <line x1="18" y1="14" x2="38" y2="14" />
+    <!-- Right vertical for P bowl -->
+    <line x1="38" y1="14" x2="38" y2="32" />
+    <!-- Bottom horizontal of P bowl -->
+    <line x1="38" y1="32" x2="18" y2="32" />
+    <!-- Negation mark (¬) in upper-right -->
+    <line x1="42" y1="14" x2="46" y2="14" />
+    <line x1="42" y1="14" x2="42" y2="18" />
+  </g>
+</svg>

pnotp-0.1.0/plat/exports/monogram-white.svg

@@ -0,0 +1,15 @@
+<svg width="64" height="64" viewBox="0 0 64 64" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <g stroke-width="1.5" stroke="#FFFFFF" stroke-linecap="square" stroke-linejoin="miter">
+    <!-- Left vertical stem -->
+    <line x1="18" y1="14" x2="18" y2="50" />
+    <!-- Top horizontal -->
+    <line x1="18" y1="14" x2="38" y2="14" />
+    <!-- Right vertical for P bowl -->
+    <line x1="38" y1="14" x2="38" y2="32" />
+    <!-- Bottom horizontal of P bowl -->
+    <line x1="38" y1="32" x2="18" y2="32" />
+    <!-- Negation mark (¬) in upper-right -->
+    <line x1="42" y1="14" x2="46" y2="14" />
+    <line x1="42" y1="14" x2="42" y2="18" />
+  </g>
+</svg>

pnotp-0.1.0/plat/exports/wordmark-black.svg

@@ -0,0 +1,3 @@
+<svg width="200" height="80" viewBox="0 0 200 80" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <text x="50%" y="50%" dominant-baseline="middle" text-anchor="middle" font-family="Inter, system-ui, sans-serif" font-size="48" font-weight="500" fill="#000000" letter-spacing="0.96">P¬P</text>
+</svg>

pnotp-0.1.0/plat/exports/wordmark-white.svg

@@ -0,0 +1,3 @@
+<svg width="200" height="80" viewBox="0 0 200 80" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <text x="50%" y="50%" dominant-baseline="middle" text-anchor="middle" font-family="Inter, system-ui, sans-serif" font-size="48" font-weight="500" fill="#FFFFFF" letter-spacing="0.96">P¬P</text>
+</svg>

pnotp-0.1.0/pnotp/__init__.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+"""Public entrypoint for the pnotp client library."""
+
+import os
+
+from .client import Client as _Client, DEFAULT_BASE_URL
+
+
+def client(api_key: str | None = None, base_url: str | None = None) -> _Client:
+    """
+    Factory for the PnotP client.
+
+    If no api_key is provided, the loader will pull it from the environment
+    using (in order): PNOTP_API_KEY, pnotp_API_KEY.
+    The base URL defaults to the production endpoint unless explicitly overridden.
+    """
+    resolved_key = api_key or os.getenv("PNOTP_API_KEY") or os.getenv("pnotp_API_KEY")
+    resolved_base = base_url or DEFAULT_BASE_URL
+    return _Client(api_key=resolved_key, base_url=resolved_base)
+
+
+__all__ = ["client"]

pnotp-0.1.0/pnotp/client.py

@@ -0,0 +1,76 @@
+from __future__ import annotations
+
+from typing import List, Optional, Union
+
+import httpx
+
+from .models import RemoteModel
+
+DEFAULT_BASE_URL = "https://api.pnotp.ai/v1"
+
+
+class Client:
+    """
+    Main PnotP client.
+
+    Usage:
+        import pnotp as pnp
+        client = pnp.client(api_key="API_KEY", base_url="http://127.0.0.1:8000/v1")
+        client.models()                      # list models
+        model = client.models("pneumonia_binary_classification")
+        result = model.predict("image.jpg")
+    """
+
+    def __init__(
+        self,
+        api_key: str | None,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: float = 30.0,
+    ) -> None:
+        if not api_key:
+            raise ValueError("api_key is required. Pass it explicitly or set PNOTP_API_KEY.")
+        base = base_url.rstrip("/")
+        base_for_httpx = base if base.endswith("/") else f"{base}/"
+
+        self.api_key = api_key
+        self.base_url = base
+        self._http = httpx.Client(
+            base_url=base_for_httpx,
+            timeout=timeout,
+            headers={"X-API-Key": self.api_key},
+        )
+
+    def close(self) -> None:
+        self._http.close()
+
+    def __enter__(self) -> "Client":
+        return self
+
+    def __exit__(self, exc_type, exc, tb) -> None:
+        self.close()
+
+    def models(
+        self,
+        model: Optional[str] = None,
+    ) -> Union[List[str], RemoteModel]:
+        """
+        - If called with no args: lists all available model ids.
+        - If `model` is provided: returns a RemoteModel handle.
+        """
+        if model is None:
+            resp = self._http.get("models")
+            resp.raise_for_status()
+            data = resp.json()  # {"models": [{...}, ...]}
+
+            model_ids = [m["id"] for m in data.get("models", [])]
+
+            print("You have access to the following models:")
+            for mid in model_ids:
+                print(f"- {mid}")
+
+            return model_ids
+
+        return RemoteModel(name=model, http_client=self._http)
+
+
+__all__ = ["Client", "DEFAULT_BASE_URL"]

pnotp-0.1.0/pnotp/exceptions.py

@@ -0,0 +1,13 @@
+"""Custom exceptions for the pnotp client."""
+
+
+class PnotPError(Exception):
+    """Base error for all pnotp client exceptions."""
+
+
+class VisionOnlyError(PnotPError):
+    """Raised when attention maps are requested for non-vision models."""
+
+
+__all__ = ["PnotPError", "VisionOnlyError"]
+