Documentation

User Guide

Epochly User Guide: Configuration

Configure Epochly via environment variables, Python API, or config files. Control enhancement levels, telemetry, and fallback behavior.

Configure Epochly behavior through environment variables, API, or config files.

Configuration Hierarchy

  1. Environment variables (highest priority)
  2. Runtime API
  3. Configuration files
  4. Defaults (lowest priority)

Environment Variables

VariableDescriptionDefault
EPOCHLY_LEVELEnhancement level (0-4)0
EPOCHLY_MAX_LEVELMaximum enhancement level cap (0-4)4
EPOCHLY_MAX_WORKERSNumber of workers (1-256)8
EPOCHLY_MODEOperation modebalanced
EPOCHLY_DISABLEDisable Epochlyfalse
EPOCHLY_LOG_LEVELLog verbosityWARNING

Runtime API

import epochly
epochly.configure(
enhancement_level=2,
max_workers=4,
telemetry=True
)

Configuration File

Create epochly.toml in your project:

[epochly]
enhancement_level = 2
max_workers = 8
mode = "balanced"

Emergency Disable

export EPOCHLY_EMERGENCY_DISABLE=1

Or via API:

epochly.emergency_disable()