halyn 0.2.0__py3-none-any.whl

halyn-0.2.0.dist-info/METADATA

@@ -0,0 +1,246 @@
+Metadata-Version: 2.4
+Name: halyn
+Version: 0.2.0
+Summary: Halyn — NRP control plane with domain-scoped authorization.
+Author-email: Elmadani SALKA <Elmadani.SALKA@proton.me>
+License: MIT
+Project-URL: Homepage, https://github.com/ElmadaniS/halyn
+Project-URL: Repository, https://github.com/ElmadaniS/halyn
+Project-URL: Issues, https://github.com/ElmadaniS/halyn/issues
+Keywords: ai,browser,robotics,iot,mcp,nrp,llm,infrastructure,devops
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: nrp>=0.1.0
+Requires-Dist: aiohttp>=3.9
+Provides-Extra: enterprise
+Requires-Dist: grpcio>=1.60; extra == "enterprise"
+Requires-Dist: psycopg2-binary; extra == "enterprise"
+Requires-Dist: redis; extra == "enterprise"
+Provides-Extra: robotics
+Requires-Dist: rclpy; extra == "robotics"
+Requires-Dist: unitree-sdk2py; extra == "robotics"
+Provides-Extra: iot
+Requires-Dist: paho-mqtt; extra == "iot"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+<img src="logo.svg" width="80" alt="Halyn">
+
+# Halyn
+
+### NRP Control Plane
+
+**Connect any device to any LLM through NRP.**
+
+NRP control plane with domain-scoped authorization.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-green.svg)](https://python.org)
+[![Tests](https://img.shields.io/badge/Tests-48%20passed-brightgreen.svg)]()
+[![NRP](https://img.shields.io/badge/Protocol-NRP-orange.svg)](https://github.com/ElmadaniS/nrp)
+
+</div>
+
+---
+
+```
+you:    "How's the factory?"
+
+halyn:  All 12 arms running. Arm-7 joint 3 is 12°C above normal.
+        Soil moisture in the north field dropped to 18%.
+        3 urgent emails. Hetzner invoice due tomorrow.
+        Want me to handle any of these?
+```
+
+## What It Does
+
+Halyn connects AI to:
+
+| Domain | Examples |
+|--------|----------|
+| **Servers** | Deploy, monitor, fix, scale |
+| **Robots** | Move, pick, navigate, patrol |
+| **Sensors** | Temperature, humidity, soil, air |
+| **APIs** | Stripe, GitHub, Slack — any REST/GraphQL |
+| **Factories** | PLCs, SCADA, OPC-UA, Modbus |
+| **Smart Home** | Lights, climate, security |
+| **Vehicles** | Navigate, charge, maintain |
+| **Drones** | Survey, photograph, deliver |
+
+One protocol. One conversation. Everything.
+
+## Quick Start
+
+```bash
+pip install halyn
+
+halyn scan       # discover your world
+halyn connect    # plug your LLM
+halyn serve      # start running
+```
+
+## Any LLM
+
+```yaml
+# halyn.yml
+llm:
+  provider: claude        # or: openai, ollama, huggingface, vllm
+  model: claude-sonnet-4-20250514
+```
+
+Halyn doesn't lock you in. Claude today. Local Ollama tomorrow. Same nodes. Same drivers. Same safety.
+
+## Human Always in Control
+
+5 autonomy levels. Per domain. Per node. Per hour.
+
+| Level | Name | Behavior |
+|-------|------|----------|
+| 0 | **Manual** | AI proposes. You approve every action. |
+| 1 | **Supervised** | AI reads alone. Asks before acting. |
+| 2 | **Guided** | Safe actions alone. Dangerous = confirm. |
+| 3 | **Autonomous** | Does everything. You can interrupt anytime. |
+| 4 | **Full Auto** | Handles routine. Reports daily. |
+
+```yaml
+# halyn.yml
+domains:
+  physical:
+    level: 1                              # supervised
+    nodes: [robot/*, drone/*]
+    confirm: [move, pick, deploy]
+
+  financial:
+    level: 0                              # manual — confirm everything
+    nodes: [finance/*, bank/*]
+    blocked: [delete]
+
+  monitoring:
+    level: 4                              # full auto
+    nodes: [sensor/*, monitor/*]
+
+  infrastructure:
+    level: 2                              # guided
+    nodes: [server/*, cloud/*]
+    confirm: [restart, deploy, delete]
+```
+
+Your banking requires approval for every action. Your sensors run on autopilot. Your servers auto-handle safe ops but confirm deploys. You set the rails once. The AI rides them.
+
+## Security
+
+Not optional. Not a feature. The foundation.
+
+| Layer | What It Does |
+|-------|-------------|
+| **Auth** | API key with timing-safe HMAC |
+| **Autonomy** | 5 levels per domain, rate limiting |
+| **Shield** | Per-node safety rules from NRP |
+| **Sanitizer** | Injection, traversal, overflow protection |
+| **Audit** | SHA-256 hash-chain on disk, tamper-detectable |
+| **Watchdog** | Health monitoring, failsafe on crash |
+| **Redaction** | No internal paths or secrets in errors |
+
+If Halyn crashes, nodes enter safe state automatically.
+
+The audit trail is a hash chain. Tamper with one entry and the chain breaks. Every action records: who asked, which AI decided, what reasoning, what result, which domain policy authorized it.
+
+## Architecture
+
+```
+Any LLM
+  │  MCP
+  ▼
+Halyn Control Plane
+  │  ┌─ Autonomy (5 levels)
+  │  ├─ Audit (SHA-256 chain)
+  │  ├─ Watchdog (failsafe)
+  │  ├─ Auth + Sanitizer
+  │  └─ Memory (SQLite + FTS5)
+  │
+  │  NRP (Node Reach Protocol)
+  │
+  ├──→ SSH (servers)
+  ├──→ Docker (containers)
+  ├──→ Chrome CDP (browsers)
+  ├──→ ROS2 (robots)
+  ├──→ Unitree (humanoids)
+  ├──→ MQTT (IoT sensors)
+  ├──→ OPC-UA (industrial PLCs)
+  ├──→ HTTP Auto (any API — auto-introspected)
+  └──→ Your driver (~100 lines)
+```
+
+## HTTP Auto-Introspection
+
+Point Halyn at any API. It reads the OpenAPI/GraphQL spec. Generates the manifest. Creates the tools. Automatically.
+
+```yaml
+nodes:
+  - id: nrp://cloud/api/stripe
+    driver: http_auto
+    base_url: https://api.stripe.com/v1
+    auth_token: Bearer ${STRIPE_API_KEY}
+
+  - id: nrp://cloud/api/github
+    driver: http_auto
+    base_url: https://api.github.com
+    auth_token: Bearer ${GITHUB_TOKEN}
+```
+
+Any API in the world becomes an NRP node. Zero custom code.
+
+## Docker
+
+```bash
+docker compose up -d
+```
+
+```yaml
+# docker-compose.yml included — non-root, healthcheck, resource limits
+```
+
+## Stats
+
+| Metric | Value |
+|--------|-------|
+| Source lines | ~5,200 |
+| Drivers | 9 |
+| LLM connectors | 5 (Claude, GPT, Ollama, HF, vLLM) |
+| Tests | 48 passed, 0 failed |
+| Dependencies | 1 (aiohttp) |
+| Docker image | ~150MB |
+| MCP native | Yes (Claude.ai direct) |
+| Tested on | Real hardware across 3 countries |
+
+## Built on NRP
+
+Halyn implements the [Node Reach Protocol](https://github.com/ElmadaniS/nrp) — the universal standard for AI-to-world control. Any NRP-compatible device works with Halyn automatically.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Security
+
+See [SECURITY.md](SECURITY.md). Report vulnerabilities to Elmadani.SALKA@proton.me.
+
+## License
+
+MIT
+
+## Author
+
+**Elmadani SALKA**

halyn-0.2.0.dist-info/RECORD

@@ -0,0 +1,41 @@
+halyn/__init__.py,sha256=SEJsUf55GtgH6yVxu4GR7swhl1X2nEcFtjRsJ0xl7VA,251
+halyn/__main__.py,sha256=ug5RUKlpMTfptTsA0pWqBPKlX3eBsL3JFEuG31RCmFM,139
+halyn/audit.py,sha256=RuKy7zDz1natc3aj45MqVNZ-ehoubl-eN0CQfm_EsuE,9315
+halyn/auth.py,sha256=YI4UKduuT1h07TOxN3SJA1TIVt3PLx1QOIImIFEepQY,2891
+halyn/autonomy.py,sha256=k4ZdaRYx1BZ9zNv3WgKo7C_ttmrcM6psBsKaVdOjeDk,9605
+halyn/cli.py,sha256=OPSZMgcBvP51Px7_EYqflwlh6l0eHOKqFpMTps3_t80,6593
+halyn/config.py,sha256=UCzOYGQamqtu5thKW24ZqG9CFvmVZY5GrTQjtXbvNOc,4516
+halyn/consent.py,sha256=_fSCYfO0Uiz5MrKSWtWAtAI2tWN8gm470_MOJ6B1_Is,8460
+halyn/control_plane.py,sha256=K-lHSUjMd7sCFpXQdIqac45wcEBAz0wB5TK-8rQWpZo,12700
+halyn/discovery.py,sha256=k7sk58k19ccrqSinOWJ9OTmmMA4NrIXGvXImeyy6gZw,12493
+halyn/engine.py,sha256=OUqSkYIuNia2t5_JtXfVBE8_aHzxaQxWPolq-KrHBA8,7639
+halyn/intent.py,sha256=7fSrZMMjY8ejHe8LtFZKeK4SXBYSh_p0RKDbNWsaYTs,8875
+halyn/llm.py,sha256=fXejnnlDPhGdMHmCVbpuW6iD_C6PmRKaBu71Z1ginCg,6573
+halyn/mcp.py,sha256=FWppkd8ra0nIU4eYtiaeu1JzI-MN8v15fHjJS1rLcbg,9161
+halyn/nrp_bridge.py,sha256=dq0b8bcgBN3AZLKiXMHZKhDVNjpYkOPuI2xtGLTONeA,7837
+halyn/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+halyn/sanitizer.py,sha256=nS4F8FAa2_RrBm-3q7CQJhpJ1DyLtdl-vong1e2ykCg,3858
+halyn/server.py,sha256=YKvfMDWKkBMo4luiidgpy-EX3XHAqWhp1FSOVw7tP5I,11772
+halyn/types.py,sha256=EGFrvP64JndAjz0tXaEyhwHYbyr--PPTKhrkQT1Y_9o,2864
+halyn/watchdog.py,sha256=3YymQdPJbTAIWjTrsSSXMIRJDHWX1fPHAl7E81SjJvk,8571
+halyn/drivers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+halyn/drivers/browser.py,sha256=TqGyIvVE2k80miZHVMXc1eOyUEdlKTqLLDBDfgon5jk,2506
+halyn/drivers/dds.py,sha256=RofPi97Z_5P0t0PKTthzHIQQxktb9sOabLRHDkCJsn4,5333
+halyn/drivers/docker.py,sha256=TZnXbwwmQCpxQcaL9SHYZ7jzPAipUfHaiNcTkV-GO1s,2655
+halyn/drivers/http_auto.py,sha256=a275v8u9ZUf_RUXdkXPuglRAmgwH1khhWv35cSZBwfc,10334
+halyn/drivers/mqtt.py,sha256=bJrw7z_dW9s840TYDbjiQ-OTHrjOZs_zfi4tGYCkQMo,3147
+halyn/drivers/opcua.py,sha256=FbBl9JZD8mTm-bsyUeM383zrKVHAr60QBDpnmFdXgVw,2925
+halyn/drivers/ros2.py,sha256=6ng0_nYv2O9UKaa9i-5kGYtutMAd_wKRueHlMnMr0u8,4869
+halyn/drivers/serial.py,sha256=Rp-RnsuK887pxwUEWg005zdkH8_6vLy51Ra1HstuKpI,8919
+halyn/drivers/socket_raw.py,sha256=uLp8YCwW5HqPoX1KcCLxo3QPcVvT4QiZ9D-v56Z-WIw,5387
+halyn/drivers/ssh.py,sha256=5SVXNWT6FtPXit-20m086y78kvK_0_Hivd9LeYmCdbQ,6324
+halyn/drivers/unitree.py,sha256=4FgjuwHjNi4crX9zNpHv4_dyGhYJxZXLEYvv7rS3Gps,4199
+halyn/drivers/websocket.py,sha256=nCnMzaQxCaisImVgwiXIda9WzC6fXRYUS4ux-iFz8-0,6160
+halyn/memory/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+halyn/memory/store.py,sha256=t1A9esJ_GyGpVvpy_tyWqmY-wYm0Vvc_J7uWoEKRbIs,7859
+halyn-0.2.0.dist-info/licenses/LICENSE,sha256=1V8zEtAD2Jvara62f-5KqQtsbbuTwmczUIXCGCfSikI,657
+halyn-0.2.0.dist-info/METADATA,sha256=cgl0fdiEgilZ0bEuEN7IeoxObR47gT95cI1n41Af6K4,7025
+halyn-0.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+halyn-0.2.0.dist-info/entry_points.txt,sha256=AGo3r-d45hE1vEgYtoxXfHsUsrY8W6I_m-VeU07g4RI,41
+halyn-0.2.0.dist-info/top_level.txt,sha256=LQaZY7OfDzzWK4e54VuGhgzkJP7jpJGBKmT7BfTyJkI,6
+halyn-0.2.0.dist-info/RECORD,,

halyn-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

halyn-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+halyn = halyn.cli:main

halyn-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,15 @@
+MIT License
+
+Copyright (c) 2026 Elmadani SALKA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files, 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.

halyn-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+halyn