Metadata-Version: 2.1
Name: uhg
Version: 0.2.6
Summary: Universal Hyperbolic Geometry library using pure projective operations
Home-page: https://github.com/zachbovaird/UHG-Library
Author: Zach Bovaird
Author-email: zach.bovaird@example.com
Project-URL: Documentation, https://uhg.readthedocs.io
Project-URL: Source, https://github.com/zachbovaird/UHG-Library
Project-URL: Issues, https://github.com/zachbovaird/UHG-Library/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Security
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: torch>=1.8.0
Requires-Dist: numpy>=1.19.0
Requires-Dist: scipy>=1.6.0
Requires-Dist: torch-geometric>=2.0.0
Requires-Dist: networkx>=2.5
Requires-Dist: scikit-learn>=0.24
Requires-Dist: pandas>=1.2.0
Requires-Dist: stix2>=3.0.0
Requires-Dist: pymisp>=2.4.134
Requires-Dist: elasticsearch>=7.0.0
Requires-Dist: splunk-sdk>=1.6.0
Requires-Dist: matplotlib>=3.3.0
Requires-Dist: plotly>=4.14.0
Requires-Dist: dash>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-cov>=2.0; extra == "dev"
Requires-Dist: black>=22.0; extra == "dev"
Requires-Dist: isort>=5.0; extra == "dev"
Requires-Dist: mypy>=0.900; extra == "dev"

# Universal Hyperbolic Geometry (UHG) Library

A pure implementation of Universal Hyperbolic Geometry using projective operations, optimized for cybersecurity applications.

## Features

### Core Features
- Pure projective geometry implementation
- No differential geometry or manifold assumptions
- Cross-ratio preservation throughout
- Numerically stable operations

### Advanced Features
- UHG Metric Learning
- Multi-head Attention Mechanism
- Threat Correlation Engine
- Pattern Recognition
- Anomaly Detection

### Cybersecurity Applications
- Network Traffic Analysis
- System Event Correlation
- Behavioral Pattern Detection
- Threat Intelligence Integration
- Zero-Day Attack Detection

## Installation

Basic installation:
```bash
pip install uhg
```

With security features:
```bash
pip install uhg[security]
```

With visualization tools:
```bash
pip install uhg[viz]
```

## Quick Start

```python
from uhg import (
    ProjectiveUHG,
    UHGMultiHeadAttention,
    ThreatCorrelation
)

# Initialize threat correlation
correlation = ThreatCorrelation(
    feature_dim=8,
    num_heads=4
)

# Create indicators
indicators = [
    ThreatIndicator(
        ThreatIndicatorType.NETWORK,
        value="suspicious_pattern",
        confidence=0.9,
        context={
            "port": 443,
            "protocol": "TCP",
            "bytes_out": 1024
        }
    ),
    ThreatIndicator(
        ThreatIndicatorType.SYSTEM,
        value="malicious_process",
        confidence=0.85,
        context={
            "pid": 1234,
            "memory_usage": 50000,
            "api_calls": 15
        }
    )
]

# Analyze relationships
groups = correlation.get_correlation_groups(indicators)
relationships = correlation.analyze_indicator_relationships(indicators)
```

## Documentation

Full documentation is available at [uhg.readthedocs.io](https://uhg.readthedocs.io).

## Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
