Troubleshooting

Common issues and their solutions.

Diagnostic Tool

Run the built-in diagnostic:

epochly doctor

This checks:

Installation integrity
License status
System compatibility
Current configuration

Common Issues

No Performance Improvement

Symptoms: Code runs at same speed with Epochly.

Causes:

Workload is I/O-bound (not CPU-bound)
Code already uses optimized libraries (NumPy)
Workload too small (overhead > benefit)

Solution:

from epochly import analyze
result = analyze(your_function, your_data)
print(result.bottleneck)  # Shows: 'io', 'cpu', 'memory'
print(result.recommendation)

Stuck at Level 0

Symptoms: Enhancement level never increases.

Causes:

Function not called enough times
Unstable output detected
License limits reached

Solution:

import epochly
status = epochly.get_status(your_function)
print(status.level_history)
print(status.blocking_reason)

JIT Compilation Fails

Symptoms: Level 2 not activating.

Causes:

Unsupported Python constructs
Dynamic typing issues
External library calls

Solution:

from epochly.jit import diagnose
report = diagnose(your_function)
print(report.unsupported_features)
print(report.suggestions)

Memory Issues

Symptoms: High memory usage or OOM errors.

Solution:

epochly.configure(
    memory_limit_gb=8,
    pool_size_mb=256
)

Getting Help

GitHub Issues: github.com/epochly/epochly/issues
Documentation: /docs (this site)
Email: support@epochly.com