sethdd/cid-comparison repository overview

⁠CID Comparison Tool

A containerized environment for comparing Content Identifier (CID) generation between Singularity and Kubo CLI (IPFS). Features configurable dataset generation, automated testing workflows, and comprehensive CID analysis with detailed reporting.

⁠Features

• 🐳 Containerized Environment: Pre-configured with Singularity and Kubo CLI
• 📊 Configuration-Driven: JSON-based dataset configuration for flexible testing scenarios
• 🚀 Interactive Menu System: User-friendly entrypoint with guided workflows
• 📋 Generate Multiple test collections: Support for creating fixed or variable file sizes for sample data.
• 🔍 Comprehensive CID Analysis: Detailed comparison reports with mismatch detection
• 💾 Persistent Storage: Volume mounting for data persistence across container restarts

⁠Quick Start

⁠Using Docker Compose (Recommended)

# Start the container
docker-compose up -d

# Access the interactive menu
docker-compose exec cid-comparison menu|open-menu|start

Example docker-compose configuration

services:
  cid-comparison:
    image: sethdd/cid-comparison:latest
    container_name: cid-comparison
    hostname: cid-comparison
    restart: unless-stopped
    volumes:
      - ./data:/data
      - ./config:/home/appuser/config
    stdin_open: true
    tty: true

For more details, refer to the GitHub repository⁠.