Repository navigation
Releases: AryanDinakaran/EpochGo
Release list
EpochGo v1.1.0: Hardened Production Release (Fold-Aware Target Encodings & Automated ID Purge)
⚡ 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 instantOOM Killedkernel crash on 16GB laptops. -
The Solution: Implemented dynamic 3-tier categorical routing:
-
Low Cardinality (
$N \le 20$ ): NativeOneHotEncoder(handle_unknown='ignore'). -
High Cardinality (
$20 < N \le 500$ ): Native Scikit-LearnTargetEncoder(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.
-
Low Cardinality (
- 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:
DataProfilernow computes uniqueness ratios across all columns:- String/object columns with
uniqueness_ratio > 0.95are automatically flagged as non-predictive identifiers and dropped before pipeline synthesis. - Features with explicit identifier naming (
_id,uuid,pk,row_id) anduniqueness_ratio > 0.80are rejected. - Predictive continuous floats (e.g.
income,price) are safely preserved.
- String/object columns with
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.0Or 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
⚡ 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 --buildMaintainer: Aryan Dinakaran • Epochlypse Research
Website: epochlypse.com
License: MIT License