Metadata-Version: 2.4
Name: evosphere
Version: 1.0.0
Summary: The Evolutionary Bio-Compiler: A living engine for programming biology through evolution itself
Author-email: Krishna Bajpai <krishna@krishnabajpai.me>, Vedanshi Gupta <vedanshigupta158@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/krishnabajpai/evosphere
Project-URL: Documentation, https://evosphere.readthedocs.io
Project-URL: Repository, https://github.com/krishnabajpai/evosphere.git
Project-URL: Bug Tracker, https://github.com/krishnabajpai/evosphere/issues
Keywords: bioinformatics,evolution,quantum-computing,genomics,machine-learning
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: numpy>=1.24.0
Requires-Dist: scipy>=1.10.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: networkx>=3.0
Requires-Dist: scikit-learn>=1.3.0
Requires-Dist: torch>=2.0.0
Requires-Dist: torch-geometric>=2.3.0
Requires-Dist: qiskit>=0.45.0
Requires-Dist: qiskit-aer>=0.12.0
Requires-Dist: biopython>=1.81
Requires-Dist: plotly>=5.15.0
Requires-Dist: dash>=2.14.0
Requires-Dist: fastapi>=0.100.0
Requires-Dist: uvicorn>=0.23.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: click>=8.1.0
Requires-Dist: rich>=13.0.0
Requires-Dist: tqdm>=4.65.0
Requires-Dist: h5py>=3.9.0
Requires-Dist: zarr>=2.15.0
Requires-Dist: numba>=0.57.0
Requires-Dist: jax[cpu]>=0.4.13
Requires-Dist: optax>=0.1.7
Requires-Dist: gymnasium>=0.29.0
Requires-Dist: stable-baselines3>=2.0.0
Requires-Dist: pyvcf3>=1.0.3
Requires-Dist: pysam>=0.21.0
Requires-Dist: matplotlib>=3.7.0
Provides-Extra: quantum
Requires-Dist: qiskit-optimization>=0.6.0; extra == "quantum"
Requires-Dist: qiskit-machine-learning>=0.7.0; extra == "quantum"
Requires-Dist: pennylane>=0.32.0; extra == "quantum"
Requires-Dist: cirq>=1.2.0; extra == "quantum"
Provides-Extra: server
Requires-Dist: fastapi>=0.100.0; extra == "server"
Requires-Dist: uvicorn[standard]>=0.23.0; extra == "server"
Requires-Dist: gunicorn>=21.0.0; extra == "server"
Requires-Dist: websockets>=11.0.0; extra == "server"
Requires-Dist: aiofiles>=23.0.0; extra == "server"
Requires-Dist: python-multipart>=0.0.6; extra == "server"
Provides-Extra: cuda
Requires-Dist: cupy>=12.0.0; extra == "cuda"
Requires-Dist: torch[cuda]>=2.0.0; extra == "cuda"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.5.0; extra == "docs"
Requires-Dist: mkdocs-material>=9.2.0; extra == "docs"
Requires-Dist: mkdocstrings[python]>=0.22.0; extra == "docs"
Requires-Dist: mkdocs-jupyter>=0.24.0; extra == "docs"
Provides-Extra: test
Requires-Dist: pytest>=7.4.0; extra == "test"
Requires-Dist: pytest-cov>=4.1.0; extra == "test"
Requires-Dist: pytest-mock>=3.11.0; extra == "test"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
Requires-Dist: hypothesis>=6.82.0; extra == "test"
Provides-Extra: dev
Requires-Dist: black>=23.7.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.5.0; extra == "dev"
Requires-Dist: pre-commit>=3.3.0; extra == "dev"

# EvoSphere - The Evolutionary Bio-Compiler

[![License: Patent Pending](https://img.shields.io/badge/License-Patent%20Pending-red.svg)](LICENSE)
[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
[![Documentation Status](https://img.shields.io/badge/docs-available-green.svg)](docs/)
[![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)](https://github.com/krishnabajpai/evosphere)

> **"The first quantum-enhanced evolutionary bio-compiler for programming life itself."**

**Authors:** Krishna Bajpai and Vedanshi Gupta  
**Status:** Patent Pending (2024)  
**Version:** 1.0.0  

## 🌍 Revolutionary Overview

EvoSphere represents a paradigm shift in computational biology - the first system to integrate **quantum computing**, **evolutionary algorithms**, and **biological design** into a unified, programmable platform. Through six breakthrough patent innovations, EvoSphere doesn't just analyze biological systems—it **designs, optimizes, and evolves them in real-time**.

## ⚡ Six Patent Innovations

### 1. 🔬 HQESE - Hybrid Quantum-Evolutionary State-Space Engine
**Revolutionary quantum-classical evolution integration**
- Genomes represented as quantum basis states in Hilbert space
- Evolution modeled as unitary transformations with quantum superposition
- Quantum annealing for parallel exploration of adaptive landscapes
- **Patent Claim:** First quantum-enhanced evolutionary optimization system

### 2. 🕸️ MRAEG - Multi-Resolution Adaptive Evolutionary Graphs  
**Dynamic graph neural networks for biological modeling**
- Self-modifying graph topologies that evolve with biological systems
- Multi-resolution representations from molecular to ecosystem scales
- Graph attention mechanisms for biological relationship learning
- **Patent Claim:** First adaptive graph networks for evolutionary biology

### 3. 🔧 EvoByte - Evolutionary Bio-Compilation System
**Domain-specific biological programming language and compiler**
- Natural language bio-code compilation to Python, C++, Rust
- Evolutionary optimization integrated into compilation process
- Multi-platform deployment (CPU, GPU, quantum hardware)
- **Patent Claim:** First biological programming language with evolutionary optimization

### 4. 🧭 SEPD - Smart Evolutionary Pathway Designer
**Intelligent biological pathway design with machine learning**  
- Inverse reinforcement learning for pathway optimization
- Multi-objective constraint satisfaction with real-time adaptation
- Automated metabolic, signaling, and regulatory pathway generation
- **Patent Claim:** First ML-driven evolutionary pathway design system

### 5. 📡 EDAL - Evolutionary Data Assimilation Layer
**Real-time biological data processing and integration**
- Multi-modal biological data fusion (genomic, transcriptomic, proteomic)
- Real-time streaming data processing with Bayesian uncertainty quantification
- Adaptive model updating with new experimental observations
- **Patent Claim:** First real-time evolutionary data assimilation system

### 6. 🔗 CECE - Cross-Scale Evolutionary Coupling Engine  
**Multi-scale biological system integration and emergence detection**
- Coupling mechanisms across 8 biological scales (molecular to biosphere)
- Emergent behavior detection with phase transition analysis
- Multi-scale feedback control with stability guarantees
- **Patent Claim:** First cross-scale evolutionary coupling system with emergence detection

### 2. Multi-Resolution Adaptive Evolutionary Graph (MRAEG)
- Dynamic hierarchical graph neural networks
- Multi-scale evolution modeling (molecular → organismal → ecosystem)
- Real-time adaptation to genomic data streams

### 3. Evolutionary Bytecode & Compiler Interface (EvoByte)
- Domain-specific evolutionary programming language
- Modular composition of selective pressures
- Translates constraints into predictive trajectories

### 4. Synthetic Evolutionary Pathway Designer (SEPD)
- Inverse reinforcement learning for evolutionary control
- Design desired evolutionary outcomes
- Probabilistic robustness metrics

### 5. Evolutionary Data Assimilation Layer (EDAL)
- Real-time fusion of genomic data streams
- Ensemble Kalman filters for state updates
- Living digital twins of biological systems

### 6. Cross-Scale Evolutionary Coupling Engine (CECE)
- Unified molecular-organismal-ecosystem modeling
- Hierarchical control matrices
- Multi-scale adaptive signal propagation

## 🚀 Applications

- **Medicine**: Predict drug resistance, design evolution-aware therapies
- **Pandemic Defense**: Forecast viral mutations, preemptive vaccine design
- **Synthetic Biology**: Future-proof bioengineering, controlled evolution
- **Ecology & Agriculture**: Predict adaptation, design resilient crops

## 🛠️ Installation

### Prerequisites
- Python 3.9+
- Git
- Optional: Quantum computing access (IBM Quantum, AWS Braket)

### Quick Install
```bash
pip install evosphere
```

### Development Install
```bash
git clone https://github.com/krishnabajpai/evosphere.git
cd evosphere
pip install -e ".[dev,quantum,ml,bio]"
```

## 🎯 Quick Start

```python
from evosphere import EvoCompiler, QuantumEngine, EvolutionaryGraph

# Initialize the evolutionary compiler
compiler = EvoCompiler()

# Define a genome and environmental pressures
genome = compiler.load_genome("path/to/genome.fasta")
pressures = {
    "antibiotic_concentration": 10.0,
    "temperature": 37.0,
    "ph": 7.4
}

# Compile evolutionary trajectory
trajectory = compiler.compile(
    initial_genome=genome,
    environment=pressures,
    time_horizon=100  # generations
)

# Predict future states
future_genomes = trajectory.predict(steps=50)
resistance_probability = trajectory.calculate_resistance_risk()

print(f"Predicted resistance probability: {resistance_probability:.2%}")
```

## 📖 Documentation

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

- [Getting Started Guide](docs/getting-started.md)
- [API Reference](docs/api-reference.md)
- [Tutorial Notebooks](examples/)
- [Patent Documentation](docs/patents/)

## 🧪 Examples

Check out our [examples directory](examples/) for:
- Viral evolution prediction
- Cancer resistance modeling
- Synthetic biology design
- Ecosystem dynamics simulation

## 🤝 Contributing

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

### Development Setup
```bash
# Clone and install
git clone https://github.com/krishnabajpai/evosphere.git
cd evosphere
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black src/ tests/
```

## 📄 License

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

## 👥 Authors

- **Krishna Bajpai** - *Lead Architect* - krishna.bajpai@evosphere.bio
- **Vedanshi Gupta** - *Lead Developer* - vedanshi.gupta@evosphere.bio

## 📚 Citation

If you use EvoSphere in your research, please cite:

```bibtex
@software{bajpai2025evosphere,
  title={EvoSphere: A Quantum-Enhanced Evolutionary Bio-Compiler},
  author={Bajpai, Krishna and Gupta, Vedanshi},
  year={2025},
  url={https://github.com/krishnabajpai/evosphere}
}
```

## 🌟 Acknowledgments

- Quantum computing support provided by IBM Quantum Network
- Genomic datasets from NCBI, EBI, and collaborative research institutions
- Inspiration from the intersection of quantum computing and evolutionary biology

---

*"The future of bioinformatics is not in analyzing what was, but in programming what will be."*
