epochly 0.1.1

Epochly - Transparent performance optimization for Python applications

Epochly - Transparent Performance Optimization

Significant performance improvement with zero code changes!

Epochly provides transparent performance optimization for Python applications through a progressive enhancement system.

🚀 Installation

pip install epochly

That's it! Epochly is now ready to accelerate your Python code.

⚡ Quick Start

Method 1: Automatic Optimization (Recommended)

import epochly  # Just this import provides optimization!

# Your existing code runs faster automatically
import numpy as np

def matrix_computation():
    a = np.random.rand(1000, 1000)
    b = np.random.rand(1000, 1000)
    return np.dot(a, b)

result = matrix_computation()  # Automatically optimized!

Method 2: Selective Optimization

from epochly import optimize

@optimize
def slow_function(data):
    # This function will be optimized
    return complex_computation(data)

Method 3: Context Manager

from epochly import optimize_context

with optimize_context():
    # All code in this block is optimized
    result = heavy_computation()

✨ Key Features

• Zero Configuration: Just import and go - Epochly automatically detects and optimizes your workloads
• Progressive Enhancement: Four optimization levels from monitoring to full sub-interpreter parallelization
• 100% Compatibility: Works with existing Python code, libraries, and frameworks
• Production Ready: Controlled deployment with emergency controls and monitoring
• Transparent Activation: Automatic activation via sitecustomize.py for seamless integration

📊 Performance Results

Epochly provides transparent optimization through 5 progressive enhancement levels:

• Level 0: Monitoring and analysis
• Level 1: Basic threading optimization
• Level 2: JIT compilation
• Level 3: Full optimization with sub-interpreters and shared memory
• Level 4: GPU acceleration (when available)

Average performance improvement varies by workload type.

🎯 Use Cases

Perfect for:

• Scientific computing and data analysis
• Machine learning preprocessing
• Financial modeling
• Image and signal processing
• Any CPU-intensive Python code

🔧 Advanced Configuration

from epochly import configure, EnhancementLevel

# Set optimization level
configure(level=EnhancementLevel.LEVEL_3_FULL)

# Enable monitoring
configure(monitor_performance=True)

# Control worker threads
configure(max_workers=8)

📖 Documentation

For comprehensive documentation, visit https://epochly.com/docs

🏃 Demo

Try our performance demo:

# After installation
python -m epochly.demos.benchmark

💻 System Requirements

• Python 3.8-3.13
• Linux, macOS, or Windows
• No GPU required (CPU optimization)

🚀 Deployment

Transparent Activation

Epochly can be transparently activated for all Python processes:

# Install sitecustomize.py for automatic activation
epochly-deploy install

# Selective activation by environment
export EPOCHLY_ENABLED=1
python your_app.py

# Configuration file control
echo "enabled: true" > ~/.epochly/config.yml

Production Deployment

# Controlled rollout
epochly-deploy enable --percentage 10 --monitor-only

# Emergency disable
epochly-deploy disable --emergency

# Monitor deployment
epochly-deploy status --detailed

📊 Monitoring

Epochly provides comprehensive monitoring and observability:

import epochly

# Get performance metrics
metrics = epochly.get_metrics()
print(f"Speedup: {metrics.speedup:.2f}x")
print(f"Memory usage: {metrics.memory_mb:.1f} MB")

# Export Prometheus metrics
epochly.export_metrics(port=8080)

🔒 Security

Epochly implements comprehensive security measures:

• Memory isolation between interpreters
• Access control for shared memory
• Audit logging for all operations
• Side-channel attack mitigation
• Secure deployment controls

📚 Documentation

• Getting Started Guide
• Architecture Overview
• API Reference
• Deployment Guide
• Performance Tuning

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

# Development setup
git clone https://github.com/epochly-python/epochly.git
cd epochly
pip install -e .[dev]
pre-commit install

# Run tests
pytest

# Run benchmarks
pytest tests/performance/ --benchmark-only

📄 License

Epochly is a commercial product. See LICENSE for details.

🙏 Acknowledgments

Epochly builds upon the excellent work of:

• Python core developers for sub-interpreter support
• NumPy and SciPy communities for numerical computing foundations
• PyPy team for JIT compilation insights
• Numba developers for compilation techniques

---

Epochly - Making Python Fast, Transparently 🐍⚡