Deployment Guide Overview

Comprehensive guide for deploying Epochly in production environments.

Deployment Methods

Method	Use Case	Complexity	Control
pip install	Standard deployments	Low	High
sitecustomize	Transparent activation	Low	Medium
Docker	Containerized apps	Medium	High
Kubernetes	Orchestrated at scale	High	High
Enterprise	Custom deployment	High	Maximum

Quick Installation

# Standard installation
pip install epochly
# Verify installation
epochly doctor
# Check version
epochly --version

Transparent Activation with sitecustomize

Zero-code-change activation:

# Install sitecustomize
epochly sitecustomize install
# Validate installation
epochly sitecustomize validate
# Check status
epochly sitecustomize status
# Uninstall if needed
epochly sitecustomize uninstall

Activation Modes

Epochly supports five activation modes via EPOCHLY_MODE:

Mode	Level Range	Description
DISABLED	0	No optimization, monitoring only
MONITORING	0	Metrics collection only
CONSERVATIVE	1-2	Safe optimizations (threading, JIT)
BALANCED	2-3	Balanced performance/stability
AGGRESSIVE	3-4	Maximum performance (requires license)

# Set activation mode
export EPOCHLY_MODE=conservative
export EPOCHLY_LEVEL=2

Emergency Controls

Immediate Disable

Highest priority - overrides all other settings:

export EPOCHLY_EMERGENCY_DISABLE=1

Standard Disable

export EPOCHLY_DISABLE=1

Docker Quick Start

FROM python:3.12-slim
WORKDIR /app
# Install Epochly
RUN pip install --no-cache-dir epochly
# Copy application
COPY . .
# Configure for production
ENV EPOCHLY_MODE=conservative
ENV EPOCHLY_LEVEL=2
ENV EPOCHLY_MAX_WORKERS=8
CMD ["python", "app.py"]

Kubernetes Deployment

apiVersion: v1
kind: ConfigMap
metadata:
  name: epochly-config
data:
  EPOCHLY_MODE: "conservative"
  EPOCHLY_LEVEL: "2"
  EPOCHLY_MAX_WORKERS: "8"
  EPOCHLY_LOG_LEVEL: "WARNING"
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: app
spec:
  replicas: 3
  template:
    spec:
      containers:
      - name: app
        image: myapp:latest
        envFrom:
        - configMapRef:
            name: epochly-config
        resources:
          requests:
            cpu: "2"
            memory: "4Gi"
          limits:
            cpu: "4"
            memory: "8Gi"

Production Recommendations

Resource Allocation

Workload Type	CPU	Memory	EPOCHLY_LEVEL	EPOCHLY_MODE
Web servers (I/O)	2-4 cores	2-4GB	1	conservative
Data processing	4-8 cores	4-8GB	2	balanced
Scientific computing	8+ cores	8+ GB	3	balanced
ML/GPU workloads	8+ cores + GPU	16+ GB	4	aggressive

Best Practices

Start Conservative: Begin with Level 2 in production
Monitor Closely: Watch CPU, memory, and error rates
Test Thoroughly: Validate in staging before production
Plan Rollback: Have emergency disable procedures ready

CI/CD Integration

GitHub Actions Example

name: Deploy with Epochly
on: [push]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Install Epochly
        run: |
          pip install epochly
          epochly doctor
      - name: Run tests with Epochly
        env:
          EPOCHLY_LEVEL: 2
          EPOCHLY_MODE: conservative
        run: pytest
      - name: Deploy
        run: ./deploy.sh

GitLab CI Example

test:
  script:
    - pip install epochly
    - epochly doctor
    - EPOCHLY_LEVEL=2 pytest
  variables:
    EPOCHLY_MODE: conservative

Health Monitoring

Health Check Endpoint

from flask import Flask, jsonify
import epochly
app = Flask(__name__)
@app.route('/health/epochly')
def epochly_health():
    status = epochly.get_status()
    return jsonify({
        'healthy': status['initialized'],
        'level': status['enhancement_level'],
        'mode': status['mode'],
        'version': epochly.__version__
    }), 200 if status['initialized'] else 503

Monitoring Metrics

Key metrics to track:

epochly_initialized: System initialization status
epochly_current_level: Active enhancement level
epochly_optimization_count: Total optimizations applied
epochly_error_count: Optimization errors

CLI Runner

Run scripts with Epochly optimization:

# Basic usage
epochly run script.py
# With configuration
epochly run --level 2 --mode conservative script.py
# With arguments
epochly run script.py --arg1 value1 --arg2 value2

Production Setup - Production best practices
Docker Deployment - Container deployments
sitecustomize Installation - Transparent activation
Emergency Controls - Emergency disable procedures
Monitoring Integration - Observability setup