KZip is a next-generation command-line compression tool that combines the cutting-edge Zstandard algorithm with asynchronous I/O to deliver unparalleled performance. Whether you're archiving terabytes of data or compressing a single document, KZip adapts to your needs with intelligent compression modes and professional-grade features.

• Compression Speed: 50-200 MB/s
• Decompression Speed: 2-3x faster than compression
• Memory Efficient: 512MB maximum usage
• Multi-threaded: Auto-detects optimal thread count

📝 Text Files      ████████████████ 15:1
🖼️ Images (JPEG)   ██ 2:1
📄 Documents (PDF) ████████ 8:1
💻 Source Code     ████████████ 12:1

# 1. Download KZip
git clone https://github.com/Karthikdude/kzip.git

# 2. Install dependencies
pip install zstandard aiofiles rich

# 3. Make executable (Unix systems)
chmod +x kzip.py

# Install Python 3.11+
sudo apt update && sudo apt install python3.11 python3-pip

# Install dependencies
pip3 install zstandard aiofiles rich

# Global installation
sudo cp kzip.py /usr/local/bin/kzip
sudo chmod +x /usr/local/bin/kzip

# Install Python (using Homebrew)
brew install python@3.11

# Install dependencies
pip3 install zstandard aiofiles rich

# Global installation
sudo cp kzip.py /usr/local/bin/kzip
sudo chmod +x /usr/local/bin/kzip

# Install Python from python.org
# Then install dependencies
pip install zstandard aiofiles rich

# Create batch file for global access
echo @python "C:\path\to\kzip.py" %* > C:\Windows\System32\kzip.bat

# Install Python and pip
sudo pacman -S python python-pip

# Install dependencies
pip install zstandard aiofiles rich

# Global installation
sudo cp kzip.py /usr/local/bin/kzip
sudo chmod +x /usr/local/bin/kzip

kzip [options] [file_or_directory]

KZip v1.0.0 - High-Performance Compression Tool
========================================

Operation: Compression
Input: /home/user/documents
Output: documents.zst
Compression Level: 22 (maximum compression)
Worker Threads: 8
Max Memory: 512MB

Files processed: 1,247/1,247 | Speed: 45.2 MB/s
Progress: ████████████████████████████████ 100%

Compression Summary:
- Original size: 2,847.3 MB
- Compressed size: 284.1 MB
- Compression ratio: 10.0:1
- Total time: 1m 23s
- Average speed: 34.4 MB/s
- Files processed: 1,247
- Errors: 0

Compressing: ████████████████████ 87% | 2.1 GB/2.4 GB | 67.3 MB/s | ETA: 0:00:04

graph TD
    A[KZip CLI] --> B[Compression Engine]
    B --> C[Zstandard Compressor]
    B --> D[Async I/O Handler]
    D --> E[Progress Tracker]
    E --> F[Rich UI Console]
    
    G[File Input] --> B
    H[Directory Input] --> I[TAR Archive Builder]
    I --> B
    J[STDIN Input] --> B

# Internal Configuration
CHUNK_SIZE = 65536      # 64KB chunks
MAX_MEMORY_MB = 512     # Memory limit
MAX_WORKERS = 8         # Thread limit

pip install zstandard aiofiles rich

sudo cp kzip.py /usr/local/bin/kzip
sudo chmod +x /usr/local/bin/kzip

# Verify installation
python -c "import zstandard, aiofiles, rich; print('✅ All dependencies OK')"

# Test basic functionality
kzip --help

# Verbose mode for detailed output
kzip -v file.txt

KZip welcomes contributions! Here's how to get started:

1. 🐍 Python 3.11+ Compatibility: Ensure code works across versions
2. 🎨 Code Style: Follow existing patterns and PEP 8
3. 🧪 Testing: Test with various file types and sizes
4. 🌍 Cross-platform: Maintain Windows, macOS, and Linux support

# Fork and clone the repository
git clone https://github.com/Karthikdude/kzip.git
cd kzip

# Install development dependencies
pip install zstandard aiofiles rich

# Make your changes
# Test thoroughly
python kzip.py --help

# Submit a pull request

This project is open source. Please review license terms before commercial use.