Skip to main content
Glama
ocular-tear-film

ocular-tear-film

by Alpha-Park
README.md
# Ocular Tear Film Breakup Dynamics & Digital Asthenopia Prevention Skill

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](https://github.com/alphaparkinc/genpark-personal-agent-ocular-tear-film-breakup-ergonomics-skill)
[![OpenClaw Ready](https://img.shields.io/badge/OpenClaw-Compatible-purple.svg)](https://github.com/alphaparkinc/genpark-personal-agent-ocular-tear-film-breakup-ergonomics-skill)
[![MCP Protocol](https://img.shields.io/badge/MCP-Standard-orange.svg)](https://modelcontextprotocol.io/)

A sovereign personal agent capability for computational ophthalmic modeling of tear film breakup dynamics, Ocular Protection Index (OPI), and digital asthenopia prevention during extended screen work.

## Architecture

```mermaid
flowchart TD
    OcularInputs["NIBUT (s), Blink Rate (bpm), Incomplete Blink %"] --> OPIEngine["Ocular Protection Index (OPI = NIBUT / IBI)"]
    EnvInputs["Continuous Screen Hours, Ambient Humidity %"] --> RiskEngine["Digital Asthenopia Risk Engine (DARS: 0-100)"]
    OPIEngine & RiskEngine --> CornealState["Epithelial Exposure & Evaporative Tear Deficiency Analysis"]
    CornealState --> ActionableRules["20-20-20 Microbreak & Deliberate Complete Blink Coaching"]
```

## Quickstart

```python
from client import OcularTearFilmClient

client = OcularTearFilmClient()

# Assess tear film stability during screen usage
assessment = client.evaluate_ocular_protection_index(
    nibut_seconds=7.0,
    blink_rate_per_min=5.5,
    incomplete_blink_fraction=0.25,
    continuous_screen_time_hours=3.5,
    ambient_humidity_pct=35.0
)

print("Effective OPI:", assessment["effective_opi"])
print("Corneal Exposure Present:", assessment["is_corneal_exposure_present"])
print("Digital Asthenopia Score:", assessment["digital_asthenopia_risk_score"], "/ 100")
print("Guidance:", assessment["ergonomic_recommendation"])
```

## MCP Server Integration

Add to your `claude_desktop_config.json` or OpenClaw tool registry:

```json
{
  "mcpServers": {
    "ocular-tear-film": {
      "command": "python",
      "args": ["/path/to/genpark-personal-agent-ocular-tear-film-breakup-ergonomics-skill/mcp_server.py"]
    }
  }
}
```

## License
MIT License.