The project's README from github.com/sethGu/AutoLOGIC. As one markdown file: README.md.
AutoLOGIC is an agentic framework for automated tabular learning across classification, regression, and clustering. It converts a task specification into coordinated feature, model, optimization, and output-control plans, executes the plans with task-specific tools, and records plan revisions from validation and execution observations.
TaskSpec defines the task, dataset, primary metric, output requirements, and execution constraints.AgenticReasoningAgent coordinates four plan channels: feature engineering, model construction, optimization, and output control.autologic/agent/: agent state and observation-revision transitions.autologic/mystage1/: feature proposal, execution, and evaluation.autologic/ensemble/: task-specific end-to-end runners.autologic/utils/: model generation, ensembling, logging, and task protocols.reproduce/fig4/: benchmark execution, table construction, and Fig. 4 generation.reproduce/fig5/: mechanism, calibration, distillation, and Fig. 5 generation.reproduce/fig6/: output-control, clustering, stability, and Fig. 6 generation.legacy_sage/ and compat/: benchmark dependencies used by the reproduction scripts.configs/: task-specification examples.data/: expected dataset layout.python -m venv .venv
python -m pip install -r requirements.txt
Configure data paths and the LLM endpoint through environment variables:
OPENAI_API_KEY
OPENAI_BASE_URL
AUTOLOGIC_DATA_DIR
AUTOLOGIC_CSV_DATA_DIR
AUTOLOGIC_REGRESSION_DATA_DIR
python autologic/ensemble/classification_ensemble/classification_auto_ensemble.py --help
python autologic/ensemble/multiclassification_ensemble/multiclassification_auto_ensemble.py --help
python autologic/ensemble/regression_ensemble/regression_auto_ensemble.py --help
python autologic/ensemble/cluster_ensemble/cluster_auto_ensemble_hidden_evaluator.py --help
Each runner accepts --task-spec <path.json>. The generated protocol file contains the task specification, four plans, agent configuration, and execution transitions.
python autologic/ensemble/classification_ensemble/classification_auto_ensemble.py --task-spec configs/task_spec.classification.example.json
pwsh reproduce/fig4/run_full_benchmark.ps1
Fig. 5 and Fig. 6 scripts are organized by panel under reproduce/fig5/ and reproduce/fig6/.
python scripts/check_release.py
python scripts/build_manifest.py