Metadata-Version: 2.4
Name: spectral-guard
Version: 2.0.0
Summary: O(1) topological wormhole rejection for hallucination-free neuro-symbolic agents
Project-URL: Homepage, https://github.com/waveinity-ai/spectral-guard
Project-URL: Documentation, https://github.com/waveinity-ai/spectral-guard#readme
Author-email: Shaik Wasim Akram <wasimakram@waveinity.com>
License: Apache-2.0
Keywords: hallucination,knowledge-graph,llm-safety,neuro-symbolic,spectral-graph
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: jax>=0.4.20
Requires-Dist: neo4j>=5.0
Requires-Dist: networkx>=3.1
Requires-Dist: numpy>=1.24
Requires-Dist: pydantic>=2.0
Requires-Dist: scipy>=1.11
Provides-Extra: benchmarks
Requires-Dist: jupyter; extra == 'benchmarks'
Requires-Dist: matplotlib; extra == 'benchmarks'
Requires-Dist: sentence-transformers; extra == 'benchmarks'
Provides-Extra: dev
Requires-Dist: black; extra == 'dev'
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-cov; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Description-Content-Type: text/markdown

# SpectralGuard 🛡️

[![PyPI](https://badge.fury.io/py/spectral-guard.svg)](https://badge.fury.io/py/spectral-guard)
[![CI](https://github.com/waveinity-ai/spectral-guard/actions/workflows/ci.yml/badge.svg)](https://github.com/waveinity-ai/spectral-guard/actions/workflows/ci.yml)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org)

**O(1) topological wormhole rejection for hallucination-free neuro-symbolic agents.**

## The Problem
Contemporary neuro-symbolic agentic systems suffer from topological dilution in dynamic knowledge graphs. LLMs frequently propose edges that create "ontological wormholes"—direct connections between semantically distant concepts that bypass established hierarchical structures. 

SpectralGuard v2.0 is a hybrid spectral circuit-breaker that rejects these wormhole edges in $O(1)$ time using first-order perturbation on the combinatorial Graph Laplacian Fiedler vector.

## Quick Install
```bash
pip install spectral-guard