Skip to content

Releases: AryanDinakaran/EpochGo

EpochGo v1.1.0: Hardened Production Release (Fold-Aware Target Encodings & Automated ID Purge)

Choose a tag to compare

@AryanDinakaran AryanDinakaran released this 20 Oct 10:44

⚡ EpochGo v1.1.0: Hardened Production Release

EpochGo v1.1.0 brings industrial-grade tabular data preprocessing and mathematical leakage prevention to our 100% offline, air-gapped multi-agent AutoML engine.

Based directly on peer reviews and stress-testing against dirty, high-cardinality enterprise CSVs, this release guarantees that local pipelines will never crash consumer machines with Out-Of-Memory (OOM) errors and will never leak target information across validation folds.


🛡️ What's New & Architectural Upgrades

1. Elimination of the High-Cardinality OOM Trap (>99.9% Memory Reduction)

  • The Problem: In v1.0.0, categorical features with high cardinality (e.g. US zip codes, merchant category codes, airport codes with 1,000–40,000 distinct values) triggered OneHotEncoder(sparse_output=False). This allocated multi-gigabyte dense matrices, consuming 10GB+ RAM and triggering an instant OOM Killed kernel crash on 16GB laptops.
  • The Solution: Implemented dynamic 3-tier categorical routing:
    • Low Cardinality ($N \le 20$): Native OneHotEncoder(handle_unknown='ignore').
    • High Cardinality ($20 < N \le 500$): Native Scikit-Learn TargetEncoder(cv=5, smooth='auto'). Instead of allocating 5,000 sparse binary columns, each category is mapped to a single continuous float vector representing posterior target probability.
    • Extreme Cardinality ($N > 500$): Memory-bounded frequency/cardinality grouping.
  • Result: Memory consumption on high-cardinality features drops by >99.9%, enabling smooth tabular AutoML on 500,000-row enterprise datasets on ordinary 16GB MacBooks and x86 PCs.

2. Automated Identifier (ID) Rejection (Zero Target Leakage)

  • The Problem: Real-world tabular CSVs are plagued with non-predictive identifier columns (customer_id, patient_uuid, txn_hash, row_id). In standard pipelines, gradient-boosted decision trees (XGBoost/LightGBM) memorize these row keys, scoring 99.9% artificial training accuracy while failing completely in production.
  • The Solution: DataProfiler now computes uniqueness ratios across all columns:
    • String/object columns with uniqueness_ratio > 0.95 are automatically flagged as non-predictive identifiers and dropped before pipeline synthesis.
    • Features with explicit identifier naming (_id, uuid, pk, row_id) and uniqueness_ratio > 0.80 are rejected.
    • Predictive continuous floats (e.g. income, price) are safely preserved.

3. Fold-Aware Out-of-Fold Encoding (cv=5)

  • Supervised target encodings in naive implementations create severe target leakage by calculating global mean target values across the entire dataset.
  • EpochGo v1.1.0 strictly enforces 5-fold cross-validated out-of-fold target calculation (TargetEncoder(cv=5)), guaranteeing zero validation leakage and robust production generalization.

4. Resilient ColumnTransformer Deserialization

  • Resolved feature name resolution across nested preprocessing transformations using native preprocessor.get_feature_names_out().
  • Standalone serving scripts (serve.py) deserialize cleanly and serve predictions via FastAPI without column header mismatches.

📊 Benchmark Comparison: High-Cardinality Tabular Dataset

Metric v1.0.0 (Naive One-Hot) v1.1.0 (Fold-Aware TargetEncoder) Improvement
Columns Allocated (5,000 Categories) 5,000 columns 1 column 99.98% reduction
RAM Footprint (100k rows) ~4.2 GB ~8 MB >99% memory saved
16GB Laptop Crash Risk High (OOM Killed) 0% (100% Stable) Rock-solid stability
ID Memorization / Leakage High Risk Eliminated (Auto-purged) Production-safe

🚀 How to Update

To update your local clone of EpochGo:

git fetch --tags
git checkout v1.1.0

Or clone fresh:

git clone https://github.com/AryanDinakaran/EpochGo.git
cd EpochGo
pip install -r requirements.txt

🌐 Community & Ecosystem Progress

  • Developer Telemetry: 52 Git clones across 46 unique engineers within 48 hours of launch (35.6% visitor-to-clone conversion).
  • Enterprise Traffic: Inbound traffic verified from enterprise networks including Microsoft Teams (teams.public.onecdn.static.microsoft) and Kagi.
  • Upstream Integration: Open PR submitted to Ollama Official Integrations (Ollama PR #19056).
  • Programs: Applied to NVIDIA Inception Program with JetPack SDK and CUDA Python roadmap.

Full Changelog: v1.0.0...v1.1.0

EpochGo v1.0.0 — Autonomous Local-First Multi-Agent AutoML

Choose a tag to compare

@AryanDinakaran AryanDinakaran released this 08 Oct 21:14

⚡ EpochGo v1.0.0 — Autonomous Local-First Multi-Agent AutoML

We are thrilled to announce the official open-source release of EpochGo by Epochlypse Research!

EpochGo is an autonomous, 100% offline multi-agent machine learning platform that runs locally on your hardware with zero API keys and zero cloud costs.

🌟 What's New in v1.0.0:

  • 🔬 Agent 1 (Data Preprocessor): Automated profiling, missing value imputation, IQR outlier clipping, and scikit-learn pipeline synthesis.
  • 🏋️ Agent 2 (Model Benchmark Specialist): Benchmarks 7 baseline algorithms (XGBoost, LightGBM, CatBoost, Random Forest, Extra Trees, Gradient Boosting, Ridge/Logistic Regression) and tunes the top 3 with RandomizedSearchCV.
  • 🚀 Agent 3 (Model Serving Engineer): Dynamically synthesizes standalone FastAPI microservices (serve.py) with Pydantic type validation.
  • 💻 Prediction Playground: Interactive in-browser testing interface with real-time probability estimates.
  • ⚡ 60 FPS Web UI: Apple-grade dark mode dashboard with live WebSocket terminal log streaming and in-place DOM reconciliation.
  • 🐳 Single-Command Docker Orchestration: docker compose up --build.

📌 Quick Start

git clone https://github.com/AryanDinakaran/EpochGo.git
cd EpochGo
docker compose up --build

Maintainer: Aryan Dinakaran • Epochlypse Research
Website: epochlypse.com
License: MIT License