Install BrassCoders

One command. Works on macOS, Linux, Windows. Python 3.10+. No account, no API keys, no telemetry.

Recommended: pipx

pipx installs CLI tools into isolated virtualenvs so they don't pollute your Python environment.

# If you don't already have pipx:
$ brew install pipx # macOS
$ python3 -m pip install --user pipx # Linux / Windows
# Then:
$ pipx install brasscoders

After install, the brasscoders CLI is on your $PATH.

Verify

$ brasscoders --help
Should print the usage banner and exit 0.

First scan

# From any project directory:
$ brasscoders --offline scan

Output lands in .brass/ as a small set of YAML files. The one you'll hand to your AI assistant is .brass/ai_instructions.yaml.

The --offline flag guarantees zero outbound network calls — useful in air-gapped environments or for explicit offline runs. Without it, the unlicensed OSS install is offline by default; a licensed Paid-plan install calls our gateway for the AI enrichment step (see pricing).

Activate your license (Paid plan)

After subscribing on the pricing page, you'll receive a license key in your receipt email. Activate it once per machine:

$ brasscoders activate <your-license-key>

Then run a scan as normal — BrassCoders automatically uses AI-powered enrichment when an active license is present.

Run brasscoders license to see your status + remaining tokens. Run brasscoders portal to manage your subscription (update card, cancel, view invoices) via LemonSqueezy's hosted portal.

Alternatives

  • pip in a virtualenv:python3 -m venv .venv && source .venv/bin/activate && pip install brasscoders
  • Specific version:pipx install brasscoders==2.0.9
Requirements: Python 3.10+. Optional: Node.js 18+ if you want JS/TS scanning. BrassCoders installs bandit, pylint, pyre-check, radon, vulture, detect-secrets, py-spy, requests, and PyYAML as transitive dependencies.