Skip to content

README_PYPI.md

Latest commit

 

History

History
227 lines (169 loc) · 7.5 KB

README_PYPI.md

File metadata and controls

227 lines (169 loc) · 7.5 KB

Quantum Code

PyPI version Python 3.11+ License: MIT CI

Enterprise-Grade Multi-Model Code Analysis MCP Server

Quantum Code is a production-ready AI orchestration platform that seamlessly integrates with Claude Code CLI to deliver comprehensive code review, security analysis, and multi-agent consensus using multiple large language models simultaneously. Built for modern development teams requiring automated code quality assurance.

🚀 Key Features

Core Capabilities

  • 🔍 Automated Code Review - Comprehensive analysis with OWASP Top 10 security validation
  • 💬 Intelligent Chat - Context-aware development assistance with repository understanding
  • 🔄 Multi-Model Comparison - Parallel execution across different AI providers
  • 🎭 Consensus Engine - Multi-agent debate with independent analysis and critique
  • 🛡️ Security First - Built-in vulnerability detection and code quality assurance

Model Support

  • 🤖 Multi-Provider Integration - OpenAI GPT, Anthropic Claude, Google Gemini, OpenRouter
  • 🖥️ Hybrid Execution - Seamless mixing of CLI and API-based models
  • 🏷️ Smart Aliasing - Intuitive model shortcuts (mini, sonnet, gemini)
  • 🧵 Context Persistence - Thread-safe conversation management across review sessions

Enterprise Features

  • ⚡ High Performance - Async architecture with parallel model execution
  • 🔧 Configurable - Flexible model selection and parameter tuning
  • 📊 Analytics - Token usage tracking and performance metrics
  • 🔒 Secure - Isolated execution environments and credential management

🚀 Quick Start

Installation

pip install quantum-code

Basic Usage

# Start the MCP server
quantum-server

# Or use CLI for direct code review
quantum src/ --model gemini-3

# Get help
quantum --help

Claude Code Integration

Add to ~/.claude.json:

{
  "mcpServers": {
    "quantum": {
      "command": "quantum-server"
    }
  }
}

📊 Performance & Architecture

Performance Metrics

Capability Performance Benchmark
Multi-Model Execution ⚡ 3 models in ~10s 3x faster than sequential
Async Processing 🔄 Non-blocking I/O Python asyncio framework
Context Management 💾 Thread-safe persistence Across review sessions
Response Optimization 📊 Minimal latency Only slowest model time

System Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Claude Code   │───▶│  Quantum Code    │───▶│  AI Providers   │
│     Client      │    │   MCP Server     │    │  (GPT, Claude,  │
└─────────────────┘    └──────────────────┘    │   Gemini, etc.) │
                              │                └─────────────────┘
                              ▼
                       ┌──────────────────┐
                       │  Analysis Tools  │
                       │ • Code Review    │
                       │ • Security Scan  │
                       │ • Chat Assistant │
                       │ • Model Compare  │
                       └──────────────────┘

🤖 Supported Models

API Models

  • OpenAI: gpt-5-mini, gpt-5.2, gpt-5.1-codex
  • Anthropic: claude-haiku-4.5, claude-sonnet-4.5, claude-opus-4.5
  • Google: gemini-2.5-pro, gemini-3-flash, gemini-3-pro
  • Azure OpenAI: azure-gpt-5-mini
  • AWS Bedrock: bedrock-claude-4-5-sonnet

CLI Models

  • Gemini CLI: gemini-cli (alias: gem-cli)
  • Codex CLI: codex-cli (alias: cx-cli)
  • Claude CLI: claude-cli (alias: cl-cli)

🔧 Configuration

Environment Variables

# API Keys (at least one required)
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GEMINI_API_KEY=...

# Model Settings
DEFAULT_MODEL=gemini-3
DEFAULT_MODEL_LIST=codex,gemini-3,sonnet
DEFAULT_TEMPERATURE=0.2

# Server Settings
LOG_LEVEL=INFO
MAX_FILES_PER_REVIEW=100
MAX_FILE_SIZE_KB=50

Model Configuration

Create ~/.quantum_code/config.yaml:

version: "1.0"
models:
  my-custom-model:
    litellm_model: openai/gpt-4o
    aliases:
      - custom
    notes: "My custom GPT-4o configuration"

📋 Usage Examples

Code Review

# Review with specific model
quantum src/ --model sonnet

# Multi-model analysis
quantum src/ --models codex,gemini-3,sonnet

Interactive Chat

# Chat with repository context
quantum chat "How does the authentication work?"

Model Comparison

# Compare different approaches
quantum compare "Best state management for React app?"

🛡️ Security & Quality

  • OWASP Top 10 Analysis - Automated security vulnerability detection
  • Performance Patterns - Code efficiency and optimization suggestions
  • Architecture Review - Design pattern and structural analysis
  • Multi-Model Consensus - Cross-validation from different AI perspectives

🔄 Workflow Modes

Mode Description Use Case
codereview Systematic code analysis Code quality, security, performance
chat Interactive development help Questions, explanations, guidance
compare Multi-model comparison Architecture decisions, approach evaluation
debate Consensus building Complex decisions, validation

📈 Architecture

Core Components

  • FastMCP Server - Model Context Protocol implementation
  • LiteLLM Integration - Unified API for 100+ LLM providers
  • Async Processing - Concurrent model execution
  • Context Management - Thread-safe request scoping
  • Artifact Storage - File output management

Design Principles

  • DRY (Don't Repeat Yourself) - Single source of truth for schemas
  • Type Safety - Full Pydantic validation
  • Async-First - All I/O operations are asynchronous
  • Factory Pattern - Auto-generated MCP tools from schemas

🤝 Contributing

We welcome contributions! See our GitHub repository for:

  • Development setup instructions
  • Code standards and guidelines
  • Testing procedures
  • Pull request process

📄 License

MIT License - see LICENSE file for details.

👨‍💻 Author

Nishant Gaurav - Codewithevilxd

🔗 Links

Quantum Code - Multi-Model AI Orchestration for Superior Code Analysis