AVC (Archive Version Control) is a high-performance version control system with full bidirectional Git compatibility (kinda) through AGCL (AVC Git Compatibility Layer). Migrate existing Git repositories, collaborate with Git users, and push to GitHub/GitLab while enjoying BLAKE3 hashing, zstd compression, and multi-threaded operations.

• Build & Installation: see BUILD.md
• Usage Guide: see USAGE.md
• AGCL Guide: see AGCL_USAGE.md
• Git Collaboration: see WORKFLOW_SAMPLE.md
• Contributing: see CONTRIBUTING.md
• Notes: see NOTES.md

*Best run

**Directory is cleaned for each run

Tested on Linux with Kernel 6.15.3 source with Intel Core i3-12100F

• Bidirectional Git Compatibility (AGCL) - Full sync between AVC and Git formats
• One-command migration - Convert any Git repo to AVC instantly
• Mixed team collaboration - AVC users work with Git users seamlessly
• BLAKE3 content addressing - Fast, secure, collision-resistant hashing
• Incremental staging - avc add file1.txt file2.txt works properly
• Hierarchical tree structure - Preserves directory hierarchy (unlike flat storage)
• Empty directory support - Optional preservation with -e flag
• .avcignore support - Skip files/directories using ignore patterns
• Multi-threaded operations - Parallel processing for speed
• Intelligent compression - Smart zstd compression with size optimization
• Cross-platform builds - ARM/portable build support
• Large file support - Handles files up to 1GB with optimized memory management

• OpenMP parallelization - Multi-threaded file processing
• Fast compression - Level 6 zstd with smart detection
• Memory-efficient operations - Streaming file processing
• Optimized object storage - Git-style subdirectory structure
• Progress indicators - Real-time operation feedback
• Memory pool optimization - Efficient memory allocation for large files

• Smart compression detection - Avoids double-compressing already compressed files
• Consistent compression - Pure zstd compression with no fallbacks
• Directory removal - -r flag for recursive directory operations
• Thread configuration - Automatic CPU core detection and utilization
• Repository cleanup - clean command to remove entire repository
• Robust error handling - Detailed error messages and recovery
• Large file optimization - 1MB chunks and 1GB file size support

# Initialize repository avc init # Add files (basic) avc add file.txt avc add folder/ # Add all files in current directory (respects .avcignore) avc add . # Add with empty directory preservation avc add -e . avc add --empty-dirs folder/ # Add with fast compression avc add -f large_file.zip # Combine flags avc add -ef . # Fast compression + preserve empty dirs # Commit changes avc commit -m "Your commit message"

# Setup Git compatibility avc agcl git-init # Push to GitHub/GitLab avc agcl push # Pull from remote avc agcl pull # Migrate existing Git repo avc agcl migrate https://github.com/user/repo.git

• -m <message> - Commit message
• -r - Recursive directory operations
• --cached - Only remove from staging area
• --hard - Reset working directory
• --clean - Wipe working directory before reset
• -f, --fast - Use fast compression for speed
• -e, --empty-dirs - Preserve empty directories (creates .avckeep files)

Create a .avcignore file to exclude files/directories:

# Comments start with # *.log temp/ build/ node_modules/ .DS_Store 

• AVC Format: BLAKE3 hashes (64-char) + zstd compression
• Git Format: SHA-1 hashes (40-char) + zlib compression
• AGCL Bridge: Converts between formats seamlessly
• GitHub Compatible: Push AVC repos to any Git hosting service

• BLAKE3 hashing for fast, secure content addressing
• Git-style subdirectories (.avc/objects/ab/cdef...)
• Pure zstd compression with consistent compressed storage
• Streaming operations for memory efficiency
• Large file optimization with 1MB chunks and 1GB file support

• OpenMP parallelization for file processing
• Automatic thread detection and configuration
• Dynamic scheduling for optimal load balancing
• Thread-safe operations throughout the codebase

• Pure zstd compression for consistent performance
• No fallback compression - eliminates compatibility issues
• Large buffer support - 1MB compression buffers for big files
• Memory pool optimization - Efficient allocation for large operations

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

• Git - For inspiration and workflow concepts
• OpenSSL - For cryptographic functions
• zstd - For compression capabilities
• OpenMP - For parallel processing support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: This README and inline code comments

AVC v0.4.0 "Velocity" - The first version control system with bidirectional Git compatibility and seamless team collaboration.

Built with ❤️ by Atheria