Skip to main content

Hybrid code analysis tool with AI-powered explanations

Project description

Qodacode

Enterprise Code Intelligence Scanner - Hybrid security analysis with AI-powered explanations.

PyPI version Python 3.10+ License: MIT

What is Qodacode?

Qodacode is a hybrid code analysis tool that combines:

  • Deterministic Detection Engine: 4000+ security rules with zero false positives
  • AI Explanations: Learn why issues matter with multi-provider AI support
  • Supply Chain Security: Typosquatting and dependency attack detection

Three interfaces, one engine: CLI, TUI (interactive terminal), and MCP Server (for AI coding assistants).

Quick Start

# Install
pip install qodacode

# Quick security scan
qodacode check

# Interactive terminal interface
qodacode

# Full security audit
qodacode audit

Features

Security Analysis

  • Secret Detection: API keys, passwords, tokens, credentials
  • SAST: SQL injection, XSS, command injection, path traversal
  • Syntax Validation: Catch errors before runtime
  • Custom Rules: Project-specific patterns

Supply Chain Security

  • Typosquatting Detection: Catches malicious package impersonators
  • Known Malware Database: 30+ confirmed attack packages
  • Homoglyph Detection: Unicode lookalike attacks
  • Keyboard Proximity Analysis: Adjacent key typos

AI-Powered Learning

  • Junior Mode: Get explanations for every issue found
  • Multi-Provider: OpenAI, Anthropic, Google Gemini, Grok
  • Batch Processing: Efficient API usage

Interfaces

CLI Commands

qodacode check              # Quick scan (syntax + secrets)
qodacode audit              # Full security audit
qodacode typosquat          # Check dependencies for attacks
qodacode doctor             # Verify installation
qodacode version            # Show version

TUI (Interactive Terminal)

Launch with qodacode (no arguments):

/check      Quick scan
/audit      Full audit
/typosquat  Supply chain check
/ready      Production ready?
/mode       Toggle Junior/Senior mode
/api        Configure AI provider
/export     Save results
/help       Show commands

MCP Server (AI Integration)

11 tools for AI coding assistants:

Tool Description
quick_check Fast syntax + secrets scan
full_audit Complete security analysis
analyze_file Single file deep analysis
check_dependencies Typosquatting detection
get_issues Retrieve current issues
explain_issue AI explanation for issue
fix_issue Get fix suggestion
get_project_status Overall project health
configure_mode Set Junior/Senior mode
list_rules Available detection rules
search_patterns Search for code patterns

Production Verdict

Qodacode gives a clear answer: Can I deploy this code?

if critical_issues > 0:
    NOT READY - Fix N critical issues
else:
    READY FOR PRODUCTION (N warnings)

Philosophy: Only critical issues block deployment. High/Medium/Low are technical debt to track, not security blockers.

Detection Engine

Engine Coverage
Core Engine Syntax errors, custom patterns
Secret Detection 50+ secret patterns (API keys, tokens, passwords)
Deep SAST 4000+ security rules across languages
Supply Chain Typosquatting, malware, homoglyphs

Configuration

Configuration is stored in .qodacode/config.json:

{
  "mode": "junior",
  "language": "en",
  "ai": {
    "api_key": "sk-...",
    "provider": "openai"
  }
}

AI Provider Detection

API keys are auto-detected by prefix:

Prefix Provider
sk-ant-* Anthropic (Claude)
sk-* OpenAI (GPT)
xai-* Grok (xAI)
AIza* Google Gemini

Severity Levels

Level Meaning Action
Critical Security vulnerability Must fix before deploy
High Significant issue Should fix, doesn't block
Medium Code quality concern Review when possible
Low Minor suggestion Nice to have

Languages Supported

  • Python
  • JavaScript/TypeScript
  • Go
  • Java
  • More coming...

Why Qodacode?

Feature Qodacode Traditional Linters
Hybrid Analysis Deterministic + AI Rules only
Supply Chain Typosquatting detection No
AI Explanations Multi-provider No
Interactive TUI Modern terminal UI No
MCP Integration AI assistant ready No

Requirements

  • Python 3.10 or higher
  • pip (Python package manager)

License

MIT License - see LICENSE for details.

Links

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

qodacode-0.5.0.tar.gz (286.3 kB view details)

Uploaded Source

Built Distribution

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

qodacode-0.5.0-py3-none-any.whl (137.3 kB view details)

Uploaded Python 3

File details

Details for the file qodacode-0.5.0.tar.gz.

File metadata

  • Download URL: qodacode-0.5.0.tar.gz
  • Upload date:
  • Size: 286.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for qodacode-0.5.0.tar.gz
Algorithm Hash digest
SHA256 138f353fb71804c85f6291c1aa7801e2a50b36133fe9a8c63628e7cf2529a060
MD5 209737e0150c92f7e3af3505f0b7d54b
BLAKE2b-256 4cc98092939847d07fc5d3081e02efc5365699cff6645d60ef5ede1d0315d59b

See more details on using hashes here.

File details

Details for the file qodacode-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: qodacode-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 137.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for qodacode-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3992ba822be0b400466a2b9e0eeb2903a85cb89ce07144d8bdec28c60a464a66
MD5 85558d59bc55dbdb58b9a26417686559
BLAKE2b-256 67f699ac9ce5dfb014bf501d762f820fc297bffa8498f72857dd1627309aecf3

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