AVC - Archive Version Control v0.2.0 "Cryo Falcon" - EXPERIMENTAL

AVC (Archive Version Control) is a high-performance, Git-inspired version control system written in C. Designed for speed, efficiency, and simplicity, AVC combines the familiar Git workflow with modern optimizations including multi-threaded operations and intelligent compression.

• Build & Installation: see BUILD.md
• Usage Guide: see USAGE.md
• Contributing: see CONTRIBUTING.md

Tested on Linux with OpenSSL 3.5 LTS, multi-threaded operations enabled

• BLAKE3 content addressing - Fast, secure, collision-resistant hashing
• Git-like workflow - Familiar commands and concepts
• Multi-threaded operations - Parallel processing for speed
• Intelligent compression - Smart libdeflate compression with size optimization
• Directory support - Full recursive directory operations
• Large file support - Handles files up to 1GB with optimized memory management

• OpenMP parallelization - Multi-threaded file processing
• Fast compression - Level 6 libdeflate 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 libdeflate 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

• -m <message> - Commit message
• --no-compression - Disable compression for speed
• -r - Recursive directory operations
• --cached - Only remove from staging area
• --hard - Reset working directory
• --clean - Wipe working directory before reset

• BLAKE3 hashing for fast, secure content addressing
• Git-style subdirectories (.avc/objects/ab/cdef...)
• Pure libdeflate 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 libdeflate 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

1. Use multi-threaded operations - Automatic CPU core utilization
2. Add files in batches rather than individually
3. Use SSD storage for better I/O performance
4. Ensure sufficient RAM for parallel operations
5. Large files are optimized - 1MB chunks and 1GB file support

1. Consistent compression - Pure libdeflate for reliability
2. Focus on text files for best compression ratios
3. Large file handling - Optimized for files up to 1GB

We welcome contributions! Please see our contributing guidelines:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

# Debug build with sanitizers
mkdir build-debug && cd build-debug
cmake -DCMAKE_BUILD_TYPE=Debug ..
make

# Run tests
make test

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

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

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

AVC v0.1.5 "Arctic Fox" - Fast, efficient, and reliable version control for the modern developer.

Built with ❤️ by Atheria