Neurulation/CHPC-Autoresearch

Automated AI Research Assistant for the [CHPC](chpc.ac.za) (Center for High Performance Computing, South Africa). # chpc_autoresearch Automated AI Research Assistant for the CHPC (Center for High Performance Computing, South Africa). An agentic framework where AI coding agents conduct full research loops -- literature survey, implementation, experimentation on HPC, analysis, and documentation -- all driven by structured state files so sessions can pick up where the last left off. Github URL: git@github.com:Neurulation/CHPC-Autoresearch.git ## How It Works 1. **Human gives direction** -- e.g., "Research NN architectures for image classification" 2. **Agent creates a project** with iterations (sprints) 3. Each iteration follows the **research loop**: survey -> implement -> experiment -> analyze -> conclude 4. **State is tracked** in YAML files so new agent sessions can resume 5. **Experiments run on CHPC** via PBS job scripts (multiple can run concurrently) 6. **Results are analyzed** and the **leaderboard** below is updated ### Starting the Agent **Claude Code:** ``` /start [YOUR RESEARCH TOPIC] ``` **GitHub Copilot (or any agent):** Just say "start" -- the agent reads `.github/copilot-instructions.md` and knows what to do. **Manual prompt** (if slash commands aren't available): > Read CLAUDE.md and run /state-resume. Continue the autoresearch loop from wherever it left off. If no project exists, create one for: **[YOUR RESEARCH TOPIC]**. Work through each phase autonomously. For experiments, try SSH to CHPC directly; if that fails, give me the commands. Commit after each phase. ### Git + CHPC Strategy - **Development** happens on feature branches, merged to `develop` when ready - **CHPC always stays on `develop`** -- experiments are distinguished by Hydra configs, not branches - This means **multiple experiments can run concurrently** on CHPC (each writes to its own output directory) - The agent implements code -> merges to develop -> you pull on CHPC and `qsub` ## Quick Start ```bash # Clone and install git clone cd chpc_autoresearch pip install -e . # Configure …