loopgrade

Autonomous dependency upgrader powered by LangGraph and LLMs.

Upgrades your dependencies one at a time, runs your tests, reverts what breaks — without you touching anything.

The Problem

Running ncu -u or pip install --upgrade upgrades everything at once. When something breaks you have no idea which package caused it. So you don't upgrade. Deps rot. Security patches pile up.

loopgrade fixes this — one dependency at a time.

How It Works

1. Detects all outdated dependencies
2. Picks one, checks for version conflicts before touching any file
3. Upgrades it, runs your tests
4. Tests pass → keeps the change, moves to next dep
5. Tests fail → reverts the file automatically, logs the reason
6. Gives you a full report of what upgraded, what failed, and why

Installation

pip install loopgrade

Prerequisites:

• Python 3.10+
• For npm projects: npm install -g npm-check-updates
• A Groq or Gemini API key (both have free tiers)

Quick Start

cd your-project
loopgrade init
# add your API key to .env
loopgrade run

Supported Package Managers

• npm (package.json)
• pip (requirements.txt)

Configuration

{
  "llm_provider": "groq",
  "model": "llama-3.3-70b-versatile",
  "max_iterations": 20,
  "max_retries_per_dep": 3,
  "package_manager": "npm",
  "test_command": "npm test",
  "skip_major_versions": false,
  "skip": []
}

Links

• GitHub: https://github.com/Sagar-S-R/loopgrade
• Groq API: https://console.groq.com
• Gemini API: https://aistudio.google.com