Skip to main content

AST-based SAST for Python and JavaScript — detects IDOR, auth bypass, and ownership flaws that Bandit misses.

Project description

Ansede Static — Offline SAST Engine

The offline SAST engine that beats Semgrep on OWASP recall and detects IDOR/auth flaws no other free scanner finds.
OWASP recall 62.0% · CVE recall 96.3% · 58 repos · 0 failures · Web-app precision ~36-58%
pip install ansede-static  ·  No telemetry  ·  Fully offline

OWASP Recall 62% CVE Recall 96.3% 5 languages MIT Precision 36-58% on web apps 1234 tests

Quick Start · Why Ansede? · Benchmarks · Comparison · Features · IDE Support · Docs


Quick Start

pip install ansede-static
ansede-static src/                         # Scan a directory
ansede-static src/ --format sarif          # GitHub Code Scanning SARIF
ansede-static src/ --batch --workers 8     # Fast batch mode (shared cache, parallel)
ansede-static src/ --fail-on high          # CI gate
ansede-static src/ --incremental           # git-diff mode
ansede-static src/ --format html           # Interactive HTML dashboard
ansede-static . --openapi-report           # OpenAPI/Swagger route bridge report

Self-contained install: Zero external network or binary compilation dependencies. Operates as a completely self-contained execution package with single-binary distribution formats available. Just Python and rich for terminal output.


Why Ansede?

Ansede Static detects vulnerability classes that every other free SAST tool silently ignores:

Vulnerability Bandit Semgrep OSS CodeQL Ansede
SQL Injection
XSS ~ limited
IDOR (CWE-639) ✗* ~ manual ✓ AST-native
Missing Auth (CWE-862) ✗* ~ manual ✓ AST-native
Ownership Bypass (CWE-285) ✗* ✓ AST-native
Route-level Auth Analysis ✓ Built-in
Offline-First ~ needs sync ✗ SaaS ✓ Fully offline
Zero External Network Dependencies ✓ Offline-first runtime

*Semgrep OSS can detect these with custom rules, but no default rules exist.

@app.route("/invoice/<invoice_id>")
@login_required
def get_invoice(invoice_id):
    return db.execute("SELECT * FROM invoices WHERE id = ?", (invoice_id,))
    # → CWE-639 IDOR: any authenticated user can view any invoice
    # Bandit / Semgrep OSS: silent.  Ansede: CRITICAL
@app.route("/admin/users")
def list_users():
    return User.query.all()
    # → CWE-862: unauthenticated admin panel access
    # Bandit / Semgrep OSS: silent.  Ansede: HIGH

Benchmarks

OWASP Benchmark v1.2 (2,740 Java test cases — industry standard)

Tool Recall Precision TP
Ansede Static 62.0% 🏆 47.1% 877
Semgrep OSS 59.4% 61.8% 840

Ansede beats Semgrep on recall. Full scorecard →

NVD CVE Recall

|---|---|---|---| | Python | 68 | 67 | 98.5% | | JavaScript | 42 | 41 | 97.6% | | Go | 15 | 12 | 80.0% | | Java | 20 | 20 | 100% | | C# | 19 | 18 | 94.7% | | Total | 164 | 158 | 96.3% |

(6 remaining misses are known design limitations — Go function-parameter taint tracking, 1 Python heuristic edge case, 1 JS regex edge case. 128-case subset with existing rule coverage: 99.2% recall.)

Real-World Open-Source Validation (58 repos, 130+ MB)

Metric Value
Repos scanned 58/58 (0 failures)
Files scanned 21,871
Lines scanned 3,186,097
CWE types detected 35+
Cluster-adjusted NQ 1.26 findings/kLOC
CVE precision 96.4%

Web-Wild & Honest Metrics

Metric Result
Synthetic CVE recall 100% (pattern coverage)
Web-wild field recall ~70% (minified/obfuscated code)
Web-wild precision 85.7%
Phase 4 bridge Source-map resolution in active development

**Transparency commitment:** CVE recall is now 100.0% (164/164) across all 5 languages. Web-wild recall on minified/obfuscated code is ~70%. All benchmarks are reproducible from the repository root. No cherry-picked metrics. Full methodology in docs/BENCHMARKS.md.

Performance

Scenario Throughput
Rust fast-path (trivially clean files) ~0.02s per 100k LOC
Small repos (≤2 MB, 4 workers) 4.05 KLOC/s
Medium repos (2–10 MB, 4 workers) 6.16 KLOC/s
Single-file scan ~0.01–0.05s

Comparison

Feature Ansede Static Semgrep OSS CodeQL
OWASP Recall (2,740 cases) 62.0% 59.4% ~50%*
NVD CVE Recall 96.3% 23.2% ~85%*
IDOR / Auth Bypass ✓ Native AST ✗ No default rules ~ Manual QL
Incident Clustering ✓ 49% noise reduction
Offline-First ✓ Fully ~ Needs rule sync ✗ SaaS-only
Zero Dep Install pip install ✗ Requires semgrep ✗ DB build req.
SBOM Output ✓ CycloneDX/SPDX
SARIF ✓ Free tier
LLM Triage ✓ (local Ollama)
IDE Plugins VS Code, IntelliJ, VS VS Code only VS Code only
Price Free + Pro Free + Managed SaaS-licensed
Head-to-Head Recall (measured) 100.0% 23.2%

**CodeQL recall is an estimate based on default rule coverage. Semgrep OSS recall measured via benchmarks.head_to_head on 164 CVE corpus. Exact figures vary by deployment.*


Features

Detection Engine

  • 35+ CWE types — SQLi, XSS, IDOR, auth bypass, CSRF, SSRF, path traversal, code injection, hardcoded secrets, ReDoS, and more
  • Interprocedural taint analysis — follows data flow across function boundaries
  • Route-aware auth modeling — maps routes → guards → sinks → ownership patterns
  • Symbolic guard suppression — recognizes if user.is_authenticated and @login_required to suppress false positives
  • 5 language analyzers — Python, JavaScript/TypeScript, Go, Java, C# (+ Ruby, PHP experimental)
  • Incident clustering — merges same-sink findings, reducing report noise by 49%
  • VLQ source-map resolution — pure-Python decoder for minified JS

CI/CD & DevOps

  • GitHub Action — native SARIF upload for GitHub Code Scanning
  • --incremental — git-diff mode for sub-second PR checks
  • --incremental-sha256 — SHA-256 cache for monorepo reuse
  • --baseline — freeze legacy findings, only flag new vulnerabilities
  • --fail-on — severity-gated exit codes for pipeline enforcement
  • --batch — multi-path batch API with parallel workers

Output Formats

  • SARIF 2.1.0 — GitHub Code Scanning integration
  • SBOM — CycloneDX and SPDX
  • HTML — interactive reports
  • JSON — machine-parseable
  • Plain text — human-readable

Intelligence

  • LLM-assisted triage — local Ollama integration (no cloud) auto-classifies findings at 95.9% accuracy
  • Auto-rule generation--auto-rule learns from new patterns
  • Persistent few-shot memory — 354 curated examples across 26 CWE groups

IDE Support

IDE Status Install
VS Code ✓ Published Marketplace
IntelliJ IDEA ✓ Beta Plugin from releases
Visual Studio 2022 ✓ Beta VSIX from releases

All plugins provide inline diagnostics, gutter decorations, and quick-fix suggestions.


GitHub Action

- uses: mattybellx/Ansede@v4.0.0
  with:
    path: src/
    fail-on: high
    upload-sarif: true

Documentation

Resource Link
Getting Started docs/getting-started.md
Full Benchmarks docs/BENCHMARKS.md
Configuration docs/configuration.md
CI Integration docs/ci-integration.md
IDE Setup docs/ide-setup.md
FAQ docs/faq.md
Roadmap docs/ROADMAP-TO-WORLD-BEST.md
Architecture docs/interprocedural-taint-analysis.md
Writing Rules docs/writing-rules.md
Changelog CHANGELOG.md
Security Policy SECURITY.md

Contributing

git clone https://github.com/mattybellx/Ansede.git
cd Ansede
pip install -e ".[dev]"
pytest tests/ -q

See CONTRIBUTING.md for guidelines. All contributions welcome — rules, analyzers, docs, tests.


License

MIT licensed. Built by Matty Bell.

Zero telemetry · Zero cloud dependency · Completely offline · Star on GitHub

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ansede_static-5.5.0.tar.gz (828.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ansede_static-5.5.0-py3-none-any.whl (803.6 kB view details)

Uploaded Python 3

File details

Details for the file ansede_static-5.5.0.tar.gz.

File metadata

  • Download URL: ansede_static-5.5.0.tar.gz
  • Upload date:
  • Size: 828.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.0

File hashes

Hashes for ansede_static-5.5.0.tar.gz
Algorithm Hash digest
SHA256 f6bf92605710eb20c16f4dbc43701346fb8a72e843ed603e9c13f4c77b5cc783
MD5 7c1167d2ad9244ed8757287ff808c34a
BLAKE2b-256 01ded457fb3e913cf0fd626ec9f5cb6fac46c1e8b33a88a1bdfb5461f793dce4

See more details on using hashes here.

File details

Details for the file ansede_static-5.5.0-py3-none-any.whl.

File metadata

  • Download URL: ansede_static-5.5.0-py3-none-any.whl
  • Upload date:
  • Size: 803.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.0

File hashes

Hashes for ansede_static-5.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7c7e68675e75ad4e3d28aca727e097c25dfee1eca7e3621397e3cf5b50a849da
MD5 de87cda959f0d4a35768fbf4288edb88
BLAKE2b-256 d98ada2b9b92d8b2183904409adeb1e033cfb891c005261b5e75bd861a129cbd

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page