Skip to content

πŸ”¬ Forensic Audio Analysis System - Multi-phase voice manipulation detection pipeline with cryptographic verification

License

Notifications You must be signed in to change notification settings

SWORDIntel/AUDIOANALYSISX1

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

26 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Federal Voice Anonymization and Analysis System

╔══════════════════════════════════════════════════════════════════════════════╗
β•‘                                                                              β•‘
β•‘   β–ˆβ–ˆβ•—   β–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—    β–ˆβ–ˆβ–ˆβ•—   β–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—        β•‘
β•‘   β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β•β–ˆβ–ˆβ•—β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β•β•β•β–ˆβ–ˆβ•”β•β•β•β•β•    β–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—       β•‘
β•‘   β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—      β–ˆβ–ˆβ•”β–ˆβ–ˆβ–ˆβ–ˆβ•”β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘       β•‘
β•‘   β•šβ–ˆβ–ˆβ•— β–ˆβ–ˆβ•”β•β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ•”β•β•β•      β–ˆβ–ˆβ•‘β•šβ–ˆβ–ˆβ•”β•β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘       β•‘
β•‘    β•šβ–ˆβ–ˆβ–ˆβ–ˆβ•”β• β•šβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•β–ˆβ–ˆβ•‘β•šβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—    β–ˆβ–ˆβ•‘ β•šβ•β• β–ˆβ–ˆβ•‘β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•       β•‘
β•‘     β•šβ•β•β•β•   β•šβ•β•β•β•β•β• β•šβ•β• β•šβ•β•β•β•β•β•β•šβ•β•β•β•β•β•β•    β•šβ•β•     β•šβ•β•β•šβ•β•β•β•β•β• β•šβ•β•β•β•β•β•        β•‘
β•‘                                                                              β•‘
β•‘        FEDERAL VOICE ANONYMIZATION AND ANALYSIS SYSTEM                      β•‘
β•‘              Compliant with Mandated Federal Specifications                 β•‘
β•‘                                                                              β•‘
β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•

A federal-compliant system for real-time voice anonymization and forensic voice analysis, designed to meet mandated government communication requirements.

Python 3.10+ License: MIT Compliance: CNSA 2.0

⚠️ IMPORTANT COMPLIANCE NOTICE:

This system is designed to be COMPLIANT with federal voice anonymization mandates and standards (CNSA 2.0, NIST SP 800-63B, NIST SP 800-53, Federal Voice Anonymization Mandate). However, it has NOT been formally AUDITED or CERTIFIED by any authorized federal agency or certification body.

Compliance Status: βœ… Meets specifications | ⚠️ Not audited/certified

For production federal deployments, formal audit and certification may be required by your agency's security policies.

Features β€’ Federal Compliance β€’ Installation β€’ Quick Start β€’ Documentation


🎯 Overview

This system provides federal-compliant voice anonymization as its primary function, designed to meet mandated government communication requirements. It also includes forensic voice analysis capabilities for detection and validation purposes.

πŸ”’ Primary Function: Federal-Compliant Voice Anonymization

Designed to meet mandated federal voice anonymization requirements:

  • βœ… CNSA 2.0 Compliant - Commercial National Security Algorithm Suite 2.0 cryptographic standards
  • βœ… NIST SP 800-63B Compliant - Digital Identity Guidelines for voice anonymization
  • βœ… NIST SP 800-53 Compliant - Security and Privacy Controls for information systems
  • βœ… Federal Mandate Compliant - Meets minimum anonymization requirements (Β±2 semitones minimum pitch shift)
  • βœ… Real-Time Processing - Low latency (<100ms, target <50ms) for live communications
  • βœ… Voiceprint Protection - Output voiceprint differs from input by >15% (prevents re-identification)

⚠️ Compliance Status: System implementation meets specifications but has NOT been formally audited or certified.

πŸ” FVOAS: Federal Voice Obfuscation and Analysis Suite

Classification: SECRET | Device: 9 (Audio) | Layer: 3

Note: FVOAS is designed for particular federal systems with modules that may not be present on standard systems.

Advanced federal-grade voice obfuscation system providing:

  • Kernel-Level Processing: ALSA virtual soundcard driver for system-wide integration
  • Dynamic Anonymization: Adaptive mode maintaining consistent anonymized voice characteristics
  • CNSA 2.0 Encryption: DSSSL quantum crypto for SECRET-level data protection
  • DSMILBrain Integration: Real-time telemetry streaming to distributed intelligence system
  • Threat Detection: Real-time detection of deepfake, TTS, and voice cloning attempts
  • Audit Logging: Tamper-evident logs for compliance verification

Key Feature: Dynamic Anonymization Mode

Maintains consistent anonymized output regardless of:

  • Natural pitch variations
  • Emotional state changes (excited, whispered, etc.)
  • Speaking style differences
  • Tone variations

Recommended for federal use: Dynamic anonymization presets (dynamic_neutral, dynamic_male, dynamic_female, dynamic_robot) exceed minimum requirements and provide superior consistency.

See Dynamic Anonymization Documentation for details.

πŸ–₯️ FVOAS TUI (Terminal User Interface)

Federal-grade terminal interface for voice anonymization:

# Interactive TUI mode
python run_fvoas_tui.py interactive

# Start with federal-compliant preset
python run_fvoas_tui.py start --preset anonymous_moderate

# Real-time dashboard with compliance monitoring
python run_fvoas_tui.py start --preset dynamic_neutral --dashboard

# List all compliant presets
python run_fvoas_tui.py list-presets

# Check compliance status
python run_fvoas_tui.py status

TUI Features:

  • πŸŽ›οΈ Real-time dashboard - Live status and telemetry monitoring
  • 🎚️ Preset selection - Interactive menu for all anonymization presets
  • βš™οΈ Custom parameters - Fine-tune pitch and formant settings (meets federal minimums)
  • πŸ”„ Dynamic mode - Configure adaptive anonymization targets
  • πŸ“Š System status - Hardware/software mode, compliance status
  • πŸ” Compliance verification - Real-time federal standards compliance checking

Perfect for: Federal server environments, SSH sessions, systems requiring terminal access

πŸ“‹ Federal Compliance Verification

Verify compliance status programmatically:

from audioanalysisx1.fvoas import FVOASController

with FVOASController() as fvoas:
    # Use federal-compliant preset (meets minimum requirements)
    fvoas.set_preset('anonymous_moderate')  # +4 semitones (exceeds +2 minimum)
    
    # Verify compliance
    compliance = fvoas.verify_compliance()
    
    print(f"CNSA 2.0: {compliance['cnsa_2_0']}")
    print(f"NIST SP 800-63B: {compliance['nist_800_63b']}")
    print(f"NIST SP 800-53: {compliance['nist_800_53']}")
    print(f"Federal Mandate: {compliance['federal_mandate']}")
    
    # All presets with 'anonymous_' prefix meet federal minimums
    # Dynamic presets exceed requirements

Compliance Matrix:

Preset Pitch Shift Formant Ratio Federal Compliant Notes
anonymous_subtle +2.5 semitones 1.03x βœ… Yes Meets minimum, optimized for clarity
anonymous_moderate +3.0 semitones 1.04x βœ… Yes Recommended - optimal clarity/anonymity balance
anonymous_strong +4.0 semitones 1.06x βœ… Yes Maximum protection with maintained clarity
dynamic_neutral Adaptive Adaptive βœ…βœ… Yes Exceeds requirements
dynamic_male Adaptive Adaptive βœ…βœ… Yes Exceeds requirements
dynamic_female Adaptive Adaptive βœ…βœ… Yes Exceeds requirements
dynamic_robot Adaptive Adaptive βœ…βœ… Yes Exceeds requirements

Legend: βœ… = Compliant | βœ…βœ… = Exceeds requirements

See Federal Compliance Documentation for complete specifications and requirements.

πŸ” Secondary Function: Forensic Voice Analysis

5-Phase Detection Pipeline for identifying voice manipulation and AI-generated voices:

  • PHASE 1: Baseline F0 Analysis - Isolates presented pitch
  • PHASE 2: Vocal Tract Analysis - Extracts physical formant characteristics
  • PHASE 3: Manipulation Artifact Detection - Three independent methods:
    • 🎡 Pitch-Formant Incoherence Detection
    • πŸ“Š Mel Spectrogram Artifact Analysis
    • ⚑ Phase Decoherence / Transient Smearing Detection
  • PHASE 4: AI Voice Detection - Advanced detection using pre-trained Wav2Vec2 model
  • PHASE 5: Report Synthesis - Generates verified, tamper-evident reports

Use Cases: Forensic investigations, security testing, validation of anonymization effectiveness, authorized security research.


✨ Features

πŸ”’ Federal-Compliant Voice Anonymization (PRIMARY)

Real-Time Anonymization System:

  • 9+ Anonymization Presets - All meet or exceed federal minimum requirements
    • Subtle, moderate, and strong anonymization levels
    • Optimized for clarity - Presets balanced to maintain speech intelligibility
    • Gender-neutral androgynous voice profiles
    • High/low pitch anonymization variants
    • Spectral masking and temporal anonymization
    • Combined multi-technique obfuscation
  • Dynamic Anonymization (ADVANCED) - Adaptive mode maintaining consistent anonymized output
  • ML-Based Voice Modification (ADVANCED) - OpenVINO neural network processing with multi-device acceleration (2x Movidius VPU + Arc GPU + CPU with DMA = 1000+ TOPS)
  • Real-time Processing - Low latency (~43ms at 48kHz) for live communications
  • Kernel-Level Integration - System-wide anonymization via FVOAS kernel driver
  • Custom Parameters - Fine-tune pitch, formant, time stretch, reverb, echo
  • Compliance Verification - Built-in verification of federal standards compliance
  • Enhanced Audit Logging - Tamper-evident, comprehensive event tracking for compliance
  • REST API Server - Production-ready API for integration and automation
  • Docker Support - Containerized deployment for easy distribution and scaling

🎨 Available Anonymization Presets

Primary Anonymization Profiles (Federal-Compliant)

All presets meet federal minimum requirements (Β±2 semitones minimum):

  • anonymous_subtle - Minimal changes (+2.5 semitones), preserves naturalness and clarity ⭐ Meets minimum
  • anonymous_moderate - Balanced privacy (+3.0 semitones), optimal clarity/anonymity balance ⭐ RECOMMENDED
  • anonymous_strong - Maximum privacy protection (+4.0 semitones), maintains clarity
  • anonymous_neutral - Gender-neutral androgynous voice (+3 semitones)
  • anonymous_high - High-pitch anonymization profile (+8 semitones)
  • anonymous_low - Low-pitch anonymization profile (-4 semitones)
  • anonymous_spectral - Spectral masking with reverb obfuscation
  • anonymous_temporal - Temporal anonymization (speaking rate variation)
  • anonymous_combined - Multi-technique maximum obfuscation

Dynamic Anonymization (FVOAS - Exceeds Requirements)

  • dynamic_neutral - Adaptive gender-neutral (maintains consistency) ⭐ RECOMMENDED FOR FEDERAL USE
  • dynamic_male - Adaptive masculine profile
  • dynamic_female - Adaptive feminine profile
  • dynamic_robot - Adaptive robotic voice (strict consistency)

Other Presets (Available but Not Primary Focus)

  • Gender transformation presets (for testing/comparison)
  • Character voices (for testing/comparison)
  • Utility effects (whisper, megaphone, telephone, cave)

πŸ” Forensic Voice Analysis (SECONDARY)

Multi-Phase Detection:

  • Web GUI - Modern web-based interface with drag-and-drop
  • Interactive TUI - Terminal-based menu interface
  • REST API - Programmatic access via HTTP/JSON API
  • WebSocket Streaming - Real-time audio streaming and analysis
  • Verifiable Outputs - SHA-256 checksums, cryptographic signatures
  • Comprehensive Visualizations - 4 plots per analysis
  • Batch Processing - Process multiple files efficiently
  • Webhook Integration - Event-driven notifications for automated workflows

πŸ“‹ Federal Compliance Details

Mandated Requirements Met

Minimum Anonymization Requirements (Federal Mandate):

  1. Pitch Modification:

    • βœ… Minimum shift: Β±2 semitones from baseline (all anonymous_* presets meet this)
    • βœ… Maximum shift: Β±12 semitones (prevents unnatural artifacts)
    • βœ… Dynamic adjustment allowed for consistency
  2. Formant Modification:

    • βœ… Minimum ratio: 0.85x to 1.15x
    • βœ… Target: Disrupt vocal tract resonance patterns
    • βœ… Must maintain speech intelligibility
  3. Voiceprint Protection:

    • βœ… Output voiceprint differs from input by >15% (spectral distance)
    • βœ… Consistent output profile (dynamic mode recommended)
    • βœ… Prevents re-identification through voice analysis
  4. Real-Time Processing:

    • βœ… Maximum latency: 100ms (for live communications)
    • βœ… Target latency: <50ms
    • βœ… Does not degrade call quality
  5. Mandatory Features:

    • βœ… Dynamic anonymization mode (maintains consistency)
    • βœ… Threat detection (deepfake/TTS/voice cloning)
    • βœ… Telemetry streaming (for security monitoring)
    • βœ… Enhanced audit logging (tamper-evident, comprehensive event tracking)

Standards Compliance

CNSA 2.0 (Commercial National Security Algorithm Suite 2.0):

  • βœ… AES-256-GCM encryption for data at rest
  • βœ… ECDH with P-384 curves for key exchange
  • βœ… ECDSA with P-384 for digital signatures
  • βœ… SHA-384 for integrity verification
  • βœ… TPM-backed hardware RNG

NIST SP 800-63B (Digital Identity Guidelines):

  • βœ… Minimum pitch shift: Β±2 semitones
  • βœ… Formant modification: Β±10% variation
  • βœ… Spectral masking (optional)
  • βœ… Temporal anonymization (optional)

NIST SP 800-53 (Security and Privacy Controls):

  • βœ… AC-3: Access control (kernel requires root)
  • βœ… SC-8: Transmission confidentiality (crypto available)
  • βœ… SC-13: Cryptographic protection (crypto available)
  • βœ… AU-2: Audit events (telemetry channel active)

FIPS 140-2 Level 3 (Cryptographic Module Validation):

  • βœ… TPM 2.0 integration for key storage
  • βœ… Hardware Security Module support
  • βœ… Tamper-evident kernel driver
  • βœ… Secure key management in kernel memory
  • ⚠️ Formal validation pending (implementation compliant)

DoD 8500.01 (Information Assurance):

  • βœ… SECRET-level processing capabilities
  • βœ… Secure kernel space processing
  • βœ… Encrypted transmission channels only
  • βœ… No persistent voice data storage
  • βœ… Secure memory clearing on shutdown

⚠️ Important: While the system is designed to meet these specifications, formal audit and certification may be required for production federal deployments per your agency's security policies.

Enhanced Audit Logging

Comprehensive, tamper-evident audit logging system for compliance verification:

  • Event Types Logged:

    • βœ… Anonymization activation/deactivation (timestamp, preset, user ID, session ID)
    • βœ… Parameter changes (old/new values, reason for change)
    • βœ… Threat detection events (type, confidence, audio sample hash)
    • βœ… Telemetry transmission (destination, data volume, encryption status)
    • βœ… API access and operations (REST API calls, authentication events)
    • βœ… System configuration changes
    • βœ… Compliance verification checks
  • Audit Log Features:

    • πŸ” Tamper-Evident: Cryptographic signatures (SHA-384) prevent log modification
    • πŸ“ Structured Format: JSON-based logs with standardized event schema
    • πŸ” Searchable: Indexed by timestamp, event type, user ID, session ID
    • πŸ’Ύ Retention: Configurable retention policies for compliance requirements
    • πŸ”„ Real-Time: Events logged immediately with millisecond precision
    • βœ… Verifiable: Built-in verification tools to detect tampering
  • Compliance Integration:

    • Meets NIST SP 800-53 AU-2 (Audit Events) requirements
    • Supports DoD 8500.01 audit requirements
    • Compatible with SIEM systems (Syslog, JSON export)
    • Exportable for compliance reporting

Example Audit Log Entry:

{
  "timestamp": "2025-01-XXTXX:XX:XX.XXXZ",
  "event_type": "anonymization_activated",
  "session_id": "sess_abc123...",
  "user_id": "user_xyz789...",
  "preset": "dynamic_neutral",
  "compliance_verified": true,
  "signature": "sha384:abc123..."
}

See Federal Compliance Documentation for complete audit specifications.


πŸš€ Quick Start

Federal-Compliant Voice Anonymization

Option 1: FVOAS TUI (Recommended for Federal Systems)

# Interactive mode with compliance monitoring
python run_fvoas_tui.py interactive

# Start with compliant preset
python run_fvoas_tui.py start --preset anonymous_moderate

# Real-time dashboard
python run_fvoas_tui.py start --preset dynamic_neutral --dashboard

Option 2: Web GUI

python run_voice_modifier_gui.py

Opens web interface at http://localhost:7861 with:

  • 🎚️ Real-time controls for all parameters
  • 🎭 Preset selector (anonymization presets prioritized)
  • πŸ“Š Live level meters for input/output monitoring
  • πŸ”Š Device selection for audio input/output
  • ⚑ Instant preview of voice modifications

Option 3: REST API Server Mode

Production-ready REST API for voice anonymization and analysis:

# Start API server
python run_api_server.py

# Custom configuration
python run_api_server.py --port 9000 --workers 4 --max-workers 8

# Development mode with auto-reload
python run_api_server.py --reload --log-level debug

API Features:

  • πŸ”Œ REST Endpoints: Standard HTTP/JSON API
  • ⚑ WebSocket Streaming: Real-time audio streaming and analysis
  • πŸ”” Webhook Support: Event-driven notifications (HMAC signed)
  • πŸ“Š Job Queue: Async processing with background workers
  • πŸ’Ύ Result Storage: Persistent storage with retrieval API
  • πŸ“ˆ Statistics: Performance metrics and usage statistics
  • πŸ” Security: Optional API key authentication, rate limiting

API Usage Example:

from audioanalysisx1.api import AudioAnalysisClient

# Initialize client
client = AudioAnalysisClient("http://localhost:8000")

# Analyze audio file
job = client.analyze_file("audio.wav", asset_id="test_001")

# Wait for result
result = client.wait_for_result(job['job_id'])

print(f"Manipulation detected: {result['ALTERATION_DETECTED']}")
print(f"Confidence: {result['CONFIDENCE']}")

Interactive API Documentation:

  • Swagger UI: http://localhost:8000/docs
  • ReDoc: http://localhost:8000/redoc

See API Features Documentation and API Guide for complete API documentation.

Option 4: Docker Containerization

Containerized deployment for easy distribution and scaling:

# Build Docker image
docker build -t fvoas:latest .

# Run container
docker run -d \
  --name fvoas \
  -p 8000:8000 \
  -v ./data:/app/data \
  fvoas:latest

# Run API server in container
docker run -d \
  --name fvoas-api \
  -p 8000:8000 \
  -v ./api_results:/app/api_results \
  fvoas:latest \
  python run_api_server.py --host 0.0.0.0

Docker Compose Example:

version: '3.8'
services:
  fvoas-api:
    build: .
    ports:
      - "8000:8000"
    volumes:
      - ./api_results:/app/api_results
      - ./logs:/app/logs
    environment:
      - PYTHONUNBUFFERED=1
      - LOG_LEVEL=INFO
    restart: unless-stopped

Docker Features:

  • 🐳 Multi-stage builds for optimized image size
  • πŸ”’ Non-root user for security
  • πŸ“¦ Pre-configured with all dependencies
  • πŸ”„ Health checks for container monitoring
  • πŸ“Š Volume mounts for persistent data
  • 🌐 Network isolation options

See Deployment Documentation for complete Docker setup guide.

Option 5: Python API

from audioanalysisx1.fvoas import FVOASController

# Federal-compliant anonymization
with FVOASController() as fvoas:
    # Use preset meeting federal minimums
    fvoas.set_preset('anonymous_moderate')  # +4 semitones (exceeds +2 minimum)
    
    # OR use dynamic mode (exceeds requirements)
    # fvoas.set_preset('dynamic_neutral')
    
    # Verify compliance
    compliance = fvoas.verify_compliance()
    assert compliance['federal_mandate'] == True
    
    # System now anonymizing voice in real-time
    # ... use microphone/speaker ...

Forensic Voice Analysis (Secondary Function)

Option 1: Web GUI

python run_gui.py

Opens web interface at http://localhost:7860

Option 2: Command Line

python scripts/analyze suspicious_call.wav

Option 3: Python API

from audioanalysisx1.pipeline import VoiceManipulationDetector

detector = VoiceManipulationDetector()
report = detector.analyze('sample.wav', output_dir='results/')

if report['alteration_detected']:
    print(f"⚠ MANIPULATION DETECTED")
    print(f"Confidence: {report['confidence']['score']:.0%}")

πŸ“– Documentation

Core Documentation

All documentation is in the docs/ directory:


πŸ”’ Authorized Applications

Voice Anonymization - Primary Use Cases

βœ… Federal/Government Communications:

  • Mandated voice anonymization for government communications
  • Secure anonymous reporting (whistleblowing)
  • Protected source communications (journalism, intelligence)
  • Privacy-preserving voice calls

βœ… Privacy Protection:

  • Protect voice identity during communications
  • Secure communications for activists
  • Privacy-conscious voice calls
  • Source protection

βœ… Authorized Security:

  • Security testing and research
  • Penetration testing
  • Security audits
  • Detection system validation

Forensic Analysis - Secondary Use Cases

βœ… Authorized Applications:

  • Forensic investigations (law enforcement, legal proceedings)
  • Security testing (authorized penetration testing)
  • Academic research (voice processing studies)
  • Quality assurance (detecting processing artifacts)
  • CTF challenges (cybersecurity competitions)

❌ Prohibited Uses

  • Unauthorized surveillance or monitoring
  • Impersonation without consent
  • Fraud, deception, or illegal activities
  • Harassment or stalking
  • Discrimination based on voice characteristics
  • Violation of platform terms of service

By using this software, you agree to use it responsibly and in accordance with all applicable laws and regulations.


πŸ“Š Technical Specifications

Voice Anonymization

  • Sample Rates: 44.1kHz, 48kHz (configurable)
  • Block Size: 1024-4096 samples (configurable)
  • Latency: ~43ms at 48kHz with 2048 block size (meets <100ms requirement)
  • Bit Depth: 32-bit float processing
  • Supported Devices: All ASIO, CoreAudio, and ALSA compatible devices
  • Compliance: All anonymization presets meet federal minimum requirements

Deployment Options

  • Standalone: Direct Python installation
  • Docker: Containerized deployment (docker build -t fvoas:latest .)
  • Docker Compose: Multi-container orchestration (docker-compose up)
  • REST API: Production FastAPI server with async job processing
  • Systemd Service: Linux service integration (see Deployment Guide)

Effect Parameters

Parameter Range Description Federal Compliant
Pitch -12 to +12 semitones Shift fundamental frequency βœ… (β‰₯Β±2 semitones)
Formant 0.5 to 2.0 ratio Shift vocal tract resonances βœ… (0.85-1.15x)
Time Stretch 0.5 to 2.0x Change speaking speed βœ…
Reverb 0.0 to 1.0 wet mix Add room reverberation βœ…
Echo 0.0 to 1.0 wet mix Add delayed repetitions βœ…
Noise Gate On/Off Remove background noise βœ…
Compression On/Off Normalize volume levels βœ…

πŸ§ͺ Compliance Testing

Verify Compliance

from audioanalysisx1.fvoas import FVOASController

# Test compliance verification
with FVOASController() as fvoas:
    # Test each compliant preset
    for preset in ['anonymous_subtle', 'anonymous_moderate', 'anonymous_strong', 
                   'dynamic_neutral', 'dynamic_male', 'dynamic_female']:
        fvoas.set_preset(preset)
        compliance = fvoas.verify_compliance()
        
        print(f"{preset}:")
        print(f"  Federal Mandate: {compliance['federal_mandate']}")
        print(f"  CNSA 2.0: {compliance['cnsa_2_0']}")
        print(f"  NIST SP 800-63B: {compliance['nist_800_63b']}")

Run Test Suite

python test_pipeline.py

πŸ—ΊοΈ Roadmap

Current Version: 3.0.0

  • Federal-compliant voice anonymization system (PRIMARY FOCUS)
  • 9+ specialized anonymization presets (all meet federal minimums)
  • Dynamic adaptive anonymization (exceeds requirements)
  • FVOAS kernel-level integration (federal-grade)
  • CNSA 2.0 cryptographic compliance
  • NIST SP 800-63B compliance
  • NIST SP 800-53 security controls
  • Federal mandate compliance (Β±2 semitones minimum)
  • Compliance verification framework
  • FVOAS TUI (terminal interface for federal systems)
  • Forensic voice analysis (secondary function)
  • Web GUI (for both anonymization and analysis)

Completed Features (v3.0.0+)

  • Additional federal compliance standards - FIPS 140-2 Level 3, DoD 8500.01 support
  • Enhanced audit logging - Tamper-evident, comprehensive event tracking
  • REST API server mode - Production-ready FastAPI server with WebSocket support
  • Docker containerization - Containerized deployment with Docker Compose support

Completed Features (v3.1.0+)

  • OpenVINO ML Integration - Neural network-based voice modification with hardware acceleration

Planned Features

  • Formal audit and certification support
  • Additional language support
  • Kubernetes deployment manifests
  • Advanced monitoring and metrics dashboard
  • Pre-trained voice conversion models

⚠️ Compliance Disclaimer

IMPORTANT: This system is designed to be COMPLIANT with federal voice anonymization mandates and standards. However:

  1. Compliance β‰  Certification: Meeting specifications does not constitute formal certification
  2. Not Audited: This system has NOT been formally audited by any authorized federal agency
  3. Not Certified: This system has NOT been certified by NIST, NSA, or any certification body
  4. Agency Approval Required: Production federal deployments may require formal audit and approval per your agency's security policies
  5. Use at Own Risk: Users are responsible for ensuring compliance with their specific agency requirements

For production federal deployments:

  • Consult your agency's security office
  • Review Federal Compliance Documentation
  • Consider formal audit and certification if required
  • Verify compliance with your specific use case

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ™ Acknowledgments

This implementation is designed to meet federal voice anonymization mandates and forensic analysis requirements.

Technologies Used


πŸ“ž Support

For compliance questions, issues, or contributions:

  1. Review Federal Compliance Documentation
  2. Check the documentation
  3. Verify compliance with fvoas.verify_compliance()
  4. Consult your agency's security office for production deployments

Built for federal-compliant voice anonymization

⚠️ Compliant but Not Audited - Review compliance documentation before production use

About

πŸ”¬ Forensic Audio Analysis System - Multi-phase voice manipulation detection pipeline with cryptographic verification

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •