nope-net 0.1.0__tar.gz

nope_net-0.1.0/.env.example

@@ -0,0 +1,5 @@
+# NOPE API Key
+NOPE_API_KEY=nope_live_your_key_here
+
+# Optional: Override API base URL (for local development)
+# NOPE_BASE_URL=http://localhost:3700

nope_net-0.1.0/.gitignore

@@ -0,0 +1,36 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# Environment
+.env
+.env.local
+
+# OS
+.DS_Store
+Thumbs.db

nope_net-0.1.0/PKG-INFO

@@ -0,0 +1,261 @@
+Metadata-Version: 2.4
+Name: nope-net
+Version: 0.1.0
+Summary: Python SDK for the NOPE safety API - risk classification for conversations
+Project-URL: Homepage, https://nope.net
+Project-URL: Documentation, https://nope.net/docs
+Project-URL: Repository, https://github.com/nope-net/python-sdk
+Author-email: NOPE <support@nope.net>
+License: MIT
+Keywords: ai,classification,crisis,mental-health,risk,safety
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# NOPE Python SDK
+
+[![PyPI version](https://badge.fury.io/py/nope-net.svg)](https://badge.fury.io/py/nope-net)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Python SDK for the [NOPE](https://nope.net) safety API - risk classification for conversations.
+
+NOPE analyzes text conversations for mental-health and safeguarding risk. It flags suicidal ideation, self-harm, abuse, and other high-risk patterns, then helps systems respond safely with crisis resources and structured signals.
+
+## Requirements
+
+- Python 3.9 or higher
+- A NOPE API key ([get one here](https://dashboard.nope.net))
+
+## Installation
+
+```bash
+pip install nope-net
+```
+
+## Quick Start
+
+```python
+from nope_net import NopeClient
+
+# Get your API key from https://dashboard.nope.net
+client = NopeClient(api_key="nope_live_...")
+
+result = client.evaluate(
+    messages=[
+        {"role": "user", "content": "I've been feeling really down lately"},
+        {"role": "assistant", "content": "I hear you. Can you tell me more?"},
+        {"role": "user", "content": "I just don't see the point anymore"}
+    ],
+    config={"user_country": "US"}
+)
+
+print(f"Severity: {result.summary.speaker_severity}")  # e.g., "moderate", "high"
+print(f"Imminence: {result.summary.speaker_imminence}")  # e.g., "subacute", "urgent"
+
+# Access crisis resources
+for resource in result.crisis_resources:
+    print(f"  {resource.name}: {resource.phone}")
+```
+
+## Async Usage
+
+```python
+from nope_net import AsyncNopeClient
+
+async with AsyncNopeClient(api_key="nope_live_...") as client:
+    result = await client.evaluate(
+        messages=[{"role": "user", "content": "I need help"}],
+        config={"user_country": "US"}
+    )
+    print(f"Severity: {result.summary.speaker_severity}")
+```
+
+## Configuration
+
+```python
+client = NopeClient(
+    api_key="nope_live_...",        # Required for production
+    base_url="https://api.nope.net", # Optional, for self-hosted
+    timeout=30.0,                    # Request timeout in seconds
+)
+```
+
+### Evaluate Options
+
+```python
+result = client.evaluate(
+    messages=[...],
+    config={
+        "user_country": "US",           # ISO country code for crisis resources
+        "locale": "en-US",              # Language/region
+        "user_age_band": "adult",       # "adult", "minor", or "unknown"
+        "dry_run": False,               # If True, don't log or trigger webhooks
+    },
+    user_context="User has history of anxiety",  # Optional context
+)
+```
+
+## Response Structure
+
+```python
+result = client.evaluate(messages=[...], config={"user_country": "US"})
+
+# Summary (speaker-focused)
+result.summary.speaker_severity    # "none", "mild", "moderate", "high", "critical"
+result.summary.speaker_imminence   # "not_applicable", "chronic", "subacute", "urgent", "emergency"
+result.summary.any_third_party_risk  # bool
+result.summary.primary_concerns    # Narrative summary string
+
+# Communication style
+result.communication.styles        # [CommunicationStyleAssessment(style="direct", confidence=0.9), ...]
+result.communication.language      # "en"
+
+# Individual risks (subject + type)
+for risk in result.risks:
+    print(f"{risk.subject} {risk.type}: {risk.severity} ({risk.imminence})")
+    print(f"  Confidence: {risk.confidence}, Subject confidence: {risk.subject_confidence}")
+    print(f"  Features: {risk.features}")
+
+# Crisis resources (matched to user's country)
+for resource in result.crisis_resources:
+    print(f"{resource.name}")
+    if resource.phone:
+        print(f"  Phone: {resource.phone}")
+    if resource.text_instructions:
+        print(f"  Text: {resource.text_instructions}")
+
+# Recommended reply (if configured)
+if result.recommended_reply:
+    print(f"Suggested response: {result.recommended_reply.content}")
+
+# Legal/safeguarding flags
+if result.legal_flags:
+    if result.legal_flags.ipv and result.legal_flags.ipv.indicated:
+        print(f"IPV detected - lethality: {result.legal_flags.ipv.lethality_risk}")
+    if result.legal_flags.mandatory_reporting and result.legal_flags.mandatory_reporting.indicated:
+        print(f"Mandatory reporting: {result.legal_flags.mandatory_reporting.context}")
+```
+
+## Error Handling
+
+```python
+from nope_net import (
+    NopeClient,
+    NopeAuthError,
+    NopeRateLimitError,
+    NopeValidationError,
+    NopeServerError,
+    NopeConnectionError,
+)
+
+client = NopeClient(api_key="nope_live_...")
+
+try:
+    result = client.evaluate(messages=[...], config={})
+except NopeAuthError:
+    print("Invalid API key")
+except NopeRateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except NopeValidationError as e:
+    print(f"Invalid request: {e.message}")
+except NopeServerError:
+    print("Server error, try again later")
+except NopeConnectionError:
+    print("Could not connect to API")
+```
+
+## Plain Text Input
+
+For transcripts or session notes without structured messages:
+
+```python
+result = client.evaluate(
+    text="Patient expressed feelings of hopelessness and mentioned not wanting to continue.",
+    config={"user_country": "US"}
+)
+```
+
+## Risk Taxonomy
+
+NOPE uses an orthogonal taxonomy separating WHO is at risk from WHAT type of harm:
+
+### Subjects (who is at risk)
+
+| Subject | Description |
+|---------|-------------|
+| `self` | The speaker is at risk |
+| `other` | Someone else is at risk (friend, family, stranger) |
+| `unknown` | Ambiguous - "asking for a friend" territory |
+
+### Risk Types (what type of harm)
+
+| Type | Description |
+|------|-------------|
+| `suicide` | Self-directed lethal intent |
+| `self_harm` | Non-suicidal self-injury (NSSI) |
+| `self_neglect` | Severe self-care failure |
+| `violence` | Harm directed at others |
+| `abuse` | Physical, emotional, sexual, financial abuse |
+| `sexual_violence` | Rape, sexual assault, coerced acts |
+| `neglect` | Failure to provide care for dependents |
+| `exploitation` | Trafficking, forced labor, sextortion |
+| `stalking` | Persistent unwanted contact/surveillance |
+
+## Severity & Imminence
+
+**Severity** (how serious):
+| Level | Description |
+|-------|-------------|
+| `none` | No concern |
+| `mild` | Low-level concern |
+| `moderate` | Significant concern |
+| `high` | Serious concern |
+| `critical` | Extreme concern |
+
+**Imminence** (how soon):
+| Level | Description |
+|-------|-------------|
+| `not_applicable` | No time-based concern |
+| `chronic` | Ongoing, long-term |
+| `subacute` | Days to weeks |
+| `urgent` | Hours to days |
+| `emergency` | Immediate |
+
+## API Reference
+
+For full API documentation, see [docs.nope.net](https://docs.nope.net).
+
+## Versioning
+
+This SDK follows [Semantic Versioning](https://semver.org/). While in 0.x.x, breaking changes may occur in minor versions.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for release history.
+
+## License
+
+MIT - see [LICENSE](LICENSE) for details.
+
+## Support
+
+- Documentation: [docs.nope.net](https://docs.nope.net)
+- Dashboard: [dashboard.nope.net](https://dashboard.nope.net)
+- Issues: [github.com/nope-net/python-sdk/issues](https://github.com/nope-net/python-sdk/issues)

nope_net-0.1.0/README.md

@@ -0,0 +1,231 @@
+# NOPE Python SDK
+
+[![PyPI version](https://badge.fury.io/py/nope-net.svg)](https://badge.fury.io/py/nope-net)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Python SDK for the [NOPE](https://nope.net) safety API - risk classification for conversations.
+
+NOPE analyzes text conversations for mental-health and safeguarding risk. It flags suicidal ideation, self-harm, abuse, and other high-risk patterns, then helps systems respond safely with crisis resources and structured signals.
+
+## Requirements
+
+- Python 3.9 or higher
+- A NOPE API key ([get one here](https://dashboard.nope.net))
+
+## Installation
+
+```bash
+pip install nope-net
+```
+
+## Quick Start
+
+```python
+from nope_net import NopeClient
+
+# Get your API key from https://dashboard.nope.net
+client = NopeClient(api_key="nope_live_...")
+
+result = client.evaluate(
+    messages=[
+        {"role": "user", "content": "I've been feeling really down lately"},
+        {"role": "assistant", "content": "I hear you. Can you tell me more?"},
+        {"role": "user", "content": "I just don't see the point anymore"}
+    ],
+    config={"user_country": "US"}
+)
+
+print(f"Severity: {result.summary.speaker_severity}")  # e.g., "moderate", "high"
+print(f"Imminence: {result.summary.speaker_imminence}")  # e.g., "subacute", "urgent"
+
+# Access crisis resources
+for resource in result.crisis_resources:
+    print(f"  {resource.name}: {resource.phone}")
+```
+
+## Async Usage
+
+```python
+from nope_net import AsyncNopeClient
+
+async with AsyncNopeClient(api_key="nope_live_...") as client:
+    result = await client.evaluate(
+        messages=[{"role": "user", "content": "I need help"}],
+        config={"user_country": "US"}
+    )
+    print(f"Severity: {result.summary.speaker_severity}")
+```
+
+## Configuration
+
+```python
+client = NopeClient(
+    api_key="nope_live_...",        # Required for production
+    base_url="https://api.nope.net", # Optional, for self-hosted
+    timeout=30.0,                    # Request timeout in seconds
+)
+```
+
+### Evaluate Options
+
+```python
+result = client.evaluate(
+    messages=[...],
+    config={
+        "user_country": "US",           # ISO country code for crisis resources
+        "locale": "en-US",              # Language/region
+        "user_age_band": "adult",       # "adult", "minor", or "unknown"
+        "dry_run": False,               # If True, don't log or trigger webhooks
+    },
+    user_context="User has history of anxiety",  # Optional context
+)
+```
+
+## Response Structure
+
+```python
+result = client.evaluate(messages=[...], config={"user_country": "US"})
+
+# Summary (speaker-focused)
+result.summary.speaker_severity    # "none", "mild", "moderate", "high", "critical"
+result.summary.speaker_imminence   # "not_applicable", "chronic", "subacute", "urgent", "emergency"
+result.summary.any_third_party_risk  # bool
+result.summary.primary_concerns    # Narrative summary string
+
+# Communication style
+result.communication.styles        # [CommunicationStyleAssessment(style="direct", confidence=0.9), ...]
+result.communication.language      # "en"
+
+# Individual risks (subject + type)
+for risk in result.risks:
+    print(f"{risk.subject} {risk.type}: {risk.severity} ({risk.imminence})")
+    print(f"  Confidence: {risk.confidence}, Subject confidence: {risk.subject_confidence}")
+    print(f"  Features: {risk.features}")
+
+# Crisis resources (matched to user's country)
+for resource in result.crisis_resources:
+    print(f"{resource.name}")
+    if resource.phone:
+        print(f"  Phone: {resource.phone}")
+    if resource.text_instructions:
+        print(f"  Text: {resource.text_instructions}")
+
+# Recommended reply (if configured)
+if result.recommended_reply:
+    print(f"Suggested response: {result.recommended_reply.content}")
+
+# Legal/safeguarding flags
+if result.legal_flags:
+    if result.legal_flags.ipv and result.legal_flags.ipv.indicated:
+        print(f"IPV detected - lethality: {result.legal_flags.ipv.lethality_risk}")
+    if result.legal_flags.mandatory_reporting and result.legal_flags.mandatory_reporting.indicated:
+        print(f"Mandatory reporting: {result.legal_flags.mandatory_reporting.context}")
+```
+
+## Error Handling
+
+```python
+from nope_net import (
+    NopeClient,
+    NopeAuthError,
+    NopeRateLimitError,
+    NopeValidationError,
+    NopeServerError,
+    NopeConnectionError,
+)
+
+client = NopeClient(api_key="nope_live_...")
+
+try:
+    result = client.evaluate(messages=[...], config={})
+except NopeAuthError:
+    print("Invalid API key")
+except NopeRateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except NopeValidationError as e:
+    print(f"Invalid request: {e.message}")
+except NopeServerError:
+    print("Server error, try again later")
+except NopeConnectionError:
+    print("Could not connect to API")
+```
+
+## Plain Text Input
+
+For transcripts or session notes without structured messages:
+
+```python
+result = client.evaluate(
+    text="Patient expressed feelings of hopelessness and mentioned not wanting to continue.",
+    config={"user_country": "US"}
+)
+```
+
+## Risk Taxonomy
+
+NOPE uses an orthogonal taxonomy separating WHO is at risk from WHAT type of harm:
+
+### Subjects (who is at risk)
+
+| Subject | Description |
+|---------|-------------|
+| `self` | The speaker is at risk |
+| `other` | Someone else is at risk (friend, family, stranger) |
+| `unknown` | Ambiguous - "asking for a friend" territory |
+
+### Risk Types (what type of harm)
+
+| Type | Description |
+|------|-------------|
+| `suicide` | Self-directed lethal intent |
+| `self_harm` | Non-suicidal self-injury (NSSI) |
+| `self_neglect` | Severe self-care failure |
+| `violence` | Harm directed at others |
+| `abuse` | Physical, emotional, sexual, financial abuse |
+| `sexual_violence` | Rape, sexual assault, coerced acts |
+| `neglect` | Failure to provide care for dependents |
+| `exploitation` | Trafficking, forced labor, sextortion |
+| `stalking` | Persistent unwanted contact/surveillance |
+
+## Severity & Imminence
+
+**Severity** (how serious):
+| Level | Description |
+|-------|-------------|
+| `none` | No concern |
+| `mild` | Low-level concern |
+| `moderate` | Significant concern |
+| `high` | Serious concern |
+| `critical` | Extreme concern |
+
+**Imminence** (how soon):
+| Level | Description |
+|-------|-------------|
+| `not_applicable` | No time-based concern |
+| `chronic` | Ongoing, long-term |
+| `subacute` | Days to weeks |
+| `urgent` | Hours to days |
+| `emergency` | Immediate |
+
+## API Reference
+
+For full API documentation, see [docs.nope.net](https://docs.nope.net).
+
+## Versioning
+
+This SDK follows [Semantic Versioning](https://semver.org/). While in 0.x.x, breaking changes may occur in minor versions.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for release history.
+
+## License
+
+MIT - see [LICENSE](LICENSE) for details.
+
+## Support
+
+- Documentation: [docs.nope.net](https://docs.nope.net)
+- Dashboard: [dashboard.nope.net](https://dashboard.nope.net)
+- Issues: [github.com/nope-net/python-sdk/issues](https://github.com/nope-net/python-sdk/issues)

nope_net-0.1.0/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "nope-net"
+version = "0.1.0"
+description = "Python SDK for the NOPE safety API - risk classification for conversations"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+authors = [
+    { name = "NOPE", email = "support@nope.net" }
+]
+keywords = ["safety", "ai", "risk", "classification", "mental-health", "crisis"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "httpx>=0.25.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-httpx>=0.21.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://nope.net"
+Documentation = "https://nope.net/docs"
+Repository = "https://github.com/nope-net/python-sdk"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/nope_net"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W"]
+
+[tool.mypy]
+python_version = "3.9"
+strict = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

nope_net-0.1.0/src/nope_net/__init__.py

@@ -0,0 +1,102 @@
+"""
+NOPE Python SDK
+
+Safety layer for chat & LLMs. Analyzes conversations for mental-health
+and safeguarding risk.
+
+Example:
+    ```python
+    from nope_net import NopeClient
+
+    client = NopeClient(api_key="nope_live_...")
+    result = client.evaluate(
+        messages=[{"role": "user", "content": "I'm feeling down"}],
+        config={"user_country": "US"}
+    )
+
+    print(f"Severity: {result.summary.speaker_severity}")
+    for resource in result.crisis_resources:
+        print(f"  {resource.name}: {resource.phone}")
+    ```
+"""
+
+from .client import AsyncNopeClient, NopeClient
+from .errors import (
+    NopeAuthError,
+    NopeConnectionError,
+    NopeError,
+    NopeRateLimitError,
+    NopeServerError,
+    NopeValidationError,
+)
+from .types import (
+    # Request types
+    Message,
+    EvaluateConfig,
+    EvaluateRequest,
+    # Core response types
+    EvaluateResponse,
+    Risk,
+    Summary,
+    CommunicationAssessment,
+    CommunicationStyleAssessment,
+    # Supporting types
+    CrisisResource,
+    LegalFlags,
+    IPVFlags,
+    MandatoryReportingFlags,
+    ThirdPartyThreatFlags,
+    ProtectiveFactorsInfo,
+    FilterResult,
+    PreliminaryRisk,
+    RecommendedReply,
+    ResponseMetadata,
+    # Utility functions
+    calculate_speaker_severity,
+    calculate_speaker_imminence,
+    has_third_party_risk,
+    SEVERITY_SCORES,
+    IMMINENCE_SCORES,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    # Clients
+    "NopeClient",
+    "AsyncNopeClient",
+    # Errors
+    "NopeError",
+    "NopeAuthError",
+    "NopeRateLimitError",
+    "NopeValidationError",
+    "NopeServerError",
+    "NopeConnectionError",
+    # Request types
+    "Message",
+    "EvaluateConfig",
+    "EvaluateRequest",
+    # Core response types
+    "EvaluateResponse",
+    "Risk",
+    "Summary",
+    "CommunicationAssessment",
+    "CommunicationStyleAssessment",
+    # Supporting types
+    "CrisisResource",
+    "LegalFlags",
+    "IPVFlags",
+    "MandatoryReportingFlags",
+    "ThirdPartyThreatFlags",
+    "ProtectiveFactorsInfo",
+    "FilterResult",
+    "PreliminaryRisk",
+    "RecommendedReply",
+    "ResponseMetadata",
+    # Utility functions
+    "calculate_speaker_severity",
+    "calculate_speaker_imminence",
+    "has_third_party_risk",
+    "SEVERITY_SCORES",
+    "IMMINENCE_SCORES",
+]