Metadata-Version: 2.4
Name: hud-sdk
Version: 0.4.4
Summary: Hud runtime code sensor for Python
License: **Hud Technology Inc ("Hud") IDE/SDK License**
        
        
        ANY AND ALL USE OF HUD'S PROPRIETARY SOLUTIONS KNOWN AS HUD SDKS, HUD 
        IDE EXTENSIONS AND PLUGINS AND WEB APPLICATIONS ("**SOLUTION**") IS 
        SUBJECT TO: (I) FULL REGISTRATION AT [HTTPS://APP.HUD.IO](https://app.hud.io/); 
        (II) ACCEPTANCE OF THE HUD LICENSE TERMS EMAILED TO YOUR ORGANIZATION 
        BY HUD UPON COMPLETION OF THE REGISTRATION ("**TERMS**") AND (II) 
        INSTALLATION IN FULL OF THE SOLUTION. IF YOU DO NOT AGREE TO THE 
        TERMS, PLEASE DO NOT USE THE SOLUTION.
        
        Without derogating from the foregoing:
        
        Until final registration, installation and acceptance of the Terms you 
        may not use the Solution in any manner whatsoever including without 
        limitation: modify, enhance, create derivative works, decompile, 
        dissemble, reverse engineer, commercialize, make publicly available, 
        distribute, copy, reproduce, rent, lease, lend, use, translate, 
        reproduce, publish, market, license, sublicense, assign, sell, pledge, 
        resell or otherwise use the Solution in any manner. Hud’s privacy 
        practices are governed by Hud's Privacy Policy available at 
        https://www.hud.io/privacy-policy.
        
        THE SOLUTION IS HUD PROPRIETARY AND CONFIDENTIAL. THE SOLUTION AND ALL 
        IMPROVEMENTS, ENHANCEMENTS, FEEDBACK AND DERIVATIVES THEREOF AND ALL 
        INTELLECTUAL PROPERTY RIGHTS IN CONNECTION THEREWITH ("**HUD IPR**") 
        ARE EXCLUSIVELY OWNED BY HUD AND/OR ITS LICENSORS. THIS AGREEMENT DOES 
        NOT CONVEY TO YOU ANY RIGHT, TITLE OR INTEREST IN THE HUD IPR. HUD ITS 
        AFFILIATES, OFFICERS, LICENSORS AND/OR SUPPLIERS SHALL NOT BE LIABLE 
        UNDER ANY LEGAL THEORY WHETHER CONTRACT, TORT OR OTHERWISE, FOR ANY 
        DAMAGES WHATSOEVER.
        
        Notwithstanding anything to the contrary, any third-party software 
        provided as part of or with the Solution is solely governed by its 
        respective license terms made available to you as part of the download 
        process and/or clicking “install” for the respective part of the 
        Solution in any of the following: 
        [https://pypi.org/project/hud-sdk/](https://pypi.org/project/hud-sdk/#description)
        
Project-URL: Homepage, https://hud.io
Project-URL: Documentation, https://docs.hud.io
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: THIRD_PARTY_LICENSES.txt
Requires-Dist: aiohttp>=1.0.0
Requires-Dist: requests
Requires-Dist: psutil
Requires-Dist: orjson
Requires-Dist: dataclasses; python_version >= "3.6" and python_version < "3.7"
Dynamic: license-file

# Hud Python SDK

**Hud is a Runtime Code Sensor that understands your code's behavior in production, helping engineers and coding agents build production-safe code.**

---

## Why Hud

`hud-sdk` is a lightweight, low-overhead runtime sensor for production code. Installed in under a minute, it captures real-time behavior of every function in your service - including performance characteristics, error behavior, and execution patterns. This data powers Hud’s production-aware development tools across IDEs, CI/CD pipelines, and code-generating agents like Cursor and Copilot.

Hud provides continuous visibility without requiring logs, traces, or dashboards - directly from your IDE.

---

## Installation Instructions

Use Hud’s official documentation at: [https://docs.hud.io/docs/installation-guide](https://docs.hud.io/docs/installation-guide)

---

## Core Benefits & Features

- Tracks real-time function behavior: execution duration, error signals, and behavioral changes  
- Pinpoints the exact function behind regressions or degradations  
- Adapts automatically to version changes, no configuration required
- Integrates with Hud’s VS Code, JetBrains, Cursor, and CI/CD pipelines  
- Enables agentic development with real production insight via Hud’s MCP server  
- Negligible overhead. Read-only. No source code is ever transmitted  

---

## Security & Privacy

- Never accesses or transmits source code
- Only transmits anonymized function-level metadata and runtime stats  
- TLS-secured communication  
- Designed for high-throughput, production-critical environments  
- Fully compliant with:  
  - SOC 2 Type II  
  - ISO 27001  
  - GDPR  

---

## Learn More

- Docs: [https://docs.hud.io](https://docs.hud.io)  
- Live Demos: [https://www.youtube.com/@hudhq](https://www.youtube.com/@hudhq)  
- Install Hud’s MCP server: [https://docs.hud.io/docs/install-mcp](https://docs.hud.io/docs/install-mcp)
