Metadata-Version: 2.4
Name: sigma-c-framework
Version: 1.0.0
Summary: Critical Susceptibility Framework for Quantum, GPU, Financial, Climate, Seismic, and Magnetic analysis
Author-email: ForgottenForge <nfo@forgottenforge.xyz>
License: AGPL-3.0-or-later OR Commercial
Project-URL: Homepage, https://github.com/forgottenforge/sigmacore
Project-URL: Documentation, https://github.com/forgottenforge/sigmacore/blob/main/DOCUMENTATION.md
Project-URL: Repository, https://github.com/forgottenforge/sigmacore
Project-URL: Issues, https://github.com/forgottenforge/sigmacore/issues
Keywords: critical-phenomena,phase-transitions,quantum-computing,gpu-optimization,financial-analysis,climate-science,seismology,susceptibility
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
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: Programming Language :: C++
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt
License-File: license_AGPL.txt
License-File: license_COMMERCIAL.txt
Requires-Dist: numpy>=1.20.0
Requires-Dist: scipy>=1.7.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: tqdm>=4.60.0
Requires-Dist: matplotlib>=3.4.0
Requires-Dist: seaborn>=0.11.0
Requires-Dist: requests>=2.25.0
Requires-Dist: yfinance>=0.1.63
Provides-Extra: quantum
Requires-Dist: amazon-braket-sdk>=1.9.0; extra == "quantum"
Provides-Extra: gpu
Requires-Dist: cupy>=9.0.0; extra == "gpu"
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: black>=21.0; extra == "dev"
Requires-Dist: mypy>=0.900; extra == "dev"
Dynamic: license-file

[![PyPI version](https://badge.fury.io/py/sigma-c-framework.svg)](https://badge.fury.io/py/sigma-c-framework)
[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)

# Sigma-C Framework v1.0.0

**Copyright (c) 2025 ForgottenForge.xyz**

**Critical Susceptibility Framework** for Quantum, GPU, Financial, Climate, Seismic, and Magnetic analysis.

## 🚀 Quick Start

```bash
# Install the package
pip install sigma-c-framework

# Run examples
python -m sigma_c.examples.demo_quantum
```

Or clone and install from source:
```bash
git clone https://github.com/forgottenforge/sigmacore.git
cd sigmacore/sigma_c_framework
pip install .
```

## 🎯 What is Sigma-C?

Sigma-C detects **critical phase transitions** in complex systems using Critical Susceptibility (χ) theory. Unlike traditional metrics, it identifies the precise scale where systems undergo fundamental structural changes.

**Use Cases:**
- 🔬 **Quantum Computing**: Find noise thresholds that break quantum algorithms
- 🎮 **GPU Optimization**: Auto-tune kernels to avoid cache thrashing
- 💰 **Finance**: Predict market crashes before they happen
- 🌍 **Climate Science**: Identify characteristic scales of weather systems
- 🌋 **Seismology**: Detect critical stress states in earthquake catalogs
- 🧲 **Magnetism**: Analyze phase transitions (Curie temperature)

## 📦 Features

- **6 Domain Adapters** ready for production use
- **High-Performance C++ Core** with Python bindings
- **Statistical Robustness** via bootstrap and permutation tests
- **Comprehensive Documentation** in English and German
- **Dual License**: AGPL-3.0 or Commercial

## 📚 Documentation

- **Quick Start**: See [QUICKSTART.md](QUICKSTART.md) (5 minutes)
- **Full Documentation**: See [DOCUMENTATION.md](DOCUMENTATION.md) (English + German)
- **Release Guide**: See [RELEASE.md](RELEASE.md) (for contributors)
- **Changelog**: See [CHANGELOG.md](CHANGELOG.md)

## 💡 Example

```python
from sigma_c import Universe

# Detect GPU performance critical point
gpu = Universe.gpu()
result = gpu.auto_tune(alpha_levels=[0.1, 0.5, 0.9])

print(f"Critical threshold: {result['sigma_c']:.3f}")
print(f"Stability score: {result['statistics']['kappa']:.2f}")
```

## 📄 License

Dual-licensed under AGPL-3.0 or Commercial License.

- **Open Source**: See [license_AGPL.txt](license_AGPL.txt)
- **Commercial**: Contact nfo@forgottenforge.xyz

For commercial licensing without AGPL-3.0 obligations, contact: **nfo@forgottenforge.xyz**

## 🤝 Contributing

Contributions are welcome! Please read our contributing guidelines and submit pull requests.

## 📧 Contact

- **Email**: nfo@forgottenforge.xyz
- **GitHub**: [github.com/forgottenforge/sigmacore](https://github.com/forgottenforge/sigmacore)
- **Issues**: [github.com/forgottenforge/sigmacore/issues](https://github.com/forgottenforge/sigmacore/issues)

---

**Made with ❤️ by ForgottenForge**
