Skip to main content

GADE - Gradient-Aware Development Environment

Python 3.11+ PyPI License: MIT

Allocate AI compute dynamically based on code difficulty.

GADE measures difficulty across your codebase and focuses 80% of tokens on the 20% hardest regions.

Quick Start

pip install gade

# Analyze a repository (works on all systems)
python -m gade analyze ./my-project --top 20

# View heatmap
python -m gade heatmap ./my-project

Windows Users: If gade command doesn't work, use python -m gade instead. This is the recommended universal approach.

Cloud API

Use the hosted API — no setup required:

curl -X POST "https://web-production-8b5ca.up.railway.app/analyze" \
  -H "Content-Type: application/json" \
  -d '{"repo_path": "./my-project", "top_k": 10}'

📖 API Docs: web-production-8b5ca.up.railway.app/docs

Features

  • 5 Difficulty Signals: Edit churn, complexity, errors, uncertainty, gradient
  • 80/20 Allocation: Smart token distribution by difficulty
  • Multi-LLM Support: OpenAI, Anthropic, Google, Ollama, Azure, Bedrock
  • Agentic AI Ready: MCP server, OpenAI tools, LangChain integration
  • REST API: Hosted cloud API or self-host

Installation

pip install gade

Python SDK

from gade import analyze

result = analyze("./my-project")
for node in result.get_top_k(10):
    print(f"{node.node_name}: {node.difficulty_score:.2f}")

CLI Commands

Command Description
python -m gade analyze <path> Rank code by difficulty
python -m gade heatmap <path> Terminal visualization
python -m gade refactor <path> AI-assisted refactoring

Difficulty Tiers

Score Tier AI Strategy
< 0.2 compress Summarize
0.2-0.5 standard Single-pass
0.5-0.8 deep Multi-step + tools
≥ 0.8 debate Multi-pass synthesis

License

MIT

Metadata

Release files for gade 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gade 0.2.2
File Size Uploaded Provenance Actions
gade-0.2.2.tar.gz 374.5 kB Without provenance Details for gade-0.2.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for gade 0.2.2
File Interpreter ABI Platform Actions
gade-0.2.2-py3-none-any.whl Python 3 none any Details for gade-0.2.2-py3-none-any.whl

Total release size: 435.2 kB

Release files / gade-0.2.2.tar.gz

Download URL gade-0.2.2.tar.gz
Size 374.5 kB
Tags Source
SHA-256 checksum
How to use checksums
9b4fd746078df504fb64d6f8c3edf05398d6a0ae2cc8f73517346ff4e3fc55bd
BLAKE2b-256 checksum
How to use checksums
34b5c43a8749e2ac14d9c35d824dcbfde1f53c592c3fefda32be0eec6429e1bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.6

Release files / gade-0.2.2-py3-none-any.whl

Download URL gade-0.2.2-py3-none-any.whl
Size 60.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3a5200d1e6dc94a7f0780d0b0dd715bbcb5a3b21c51e87d623e4afc66730aa51
BLAKE2b-256 checksum
How to use checksums
dc65c803498a588ee4ca126acf4338b3411e0a3fbb866eb5be2cc4475f9e5ec5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.6

Security for gade 0.2.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page