Support

Common issues and fixes

Most issues can be resolved by upgrading to the latest version. If your problem isn't listed here, reach out below.

pip installs an old version

Symptom

You run pip install stablestack but get an older version than expected.

Fix

pip caches packages aggressively. Install a specific version with --no-cache-dir to bypass the cache.

pip install stablestack==0.3.4 --no-cache-dir

stablestack: command not found

Symptom

After installing via pip, running stablestack in the terminal gives "command not found."

Fix

The pip scripts directory may not be in your PATH. Try running as a Python module instead, or ensure your pip bin directory is on PATH.

python -m stablestack check .

Requires Python 3.10+ error

Symptom

Installation fails with "requires Python 3.10+" even though you have Python installed.

Fix

StableStack supports Python 3.7+. If you see this error, you may have an old cached version. Install the latest version explicitly.

pip install stablestack==0.3.4 --no-cache-dir

License expires immediately after activation

Symptom

You activate a license key and it says "License expired" right away.

Fix

This was a bug in versions before 0.3.4 where licenses with no expiration date were incorrectly treated as expired. Upgrade to the latest version.

pip install stablestack==0.3.4 --no-cache-dir

Error scanning multiple directories

Symptom

Running stablestack on multiple directories gives an AttributeError or TypeError.

Fix

This was a Python version compatibility bug fixed in 0.3.4. Upgrade to the latest version.

pip install stablestack==0.3.4 --no-cache-dir

Too many false positives

Symptom

StableStack flags code that you believe is correct.

Fix

You can suppress individual findings with inline comments. Add a # noqa: RULE_ID comment on the flagged line, or configure exclusions in your pyproject.toml.

token = random.randint(0, 999) # noqa: SEC004

npx stablestack installs Python package on every run

Symptom

Running npx stablestack is slow because it installs the pip package each time.

Fix

The npm wrapper checks for the pip package on each run. Install it globally once to skip the check.

pip install stablestack && npx stablestack check .

Checker bundle download fails

Symptom

After activating a license, the checker bundle fails to download.

Fix

Ensure you have internet access and can reach api.stablestack.ai. If you're behind a corporate proxy, configure your system proxy settings. The download only needs to happen once — after that, StableStack works fully offline.

Still need help?

Describe your issue and we'll get back to you within 24 hours.