Skip to main content

Universal, secure licensing system for QuantumMeta ecosystem packages

Project description

QuantumMeta License Server

PyPI version Python versions License Documentation

A universal, secure licensing system for the entire QuantumMeta ecosystem of PyPI packages in AI, quantum computing, and AGI.

🚀 Features

  • 🔐 Secure License Management: AES-256 encrypted .qkey files with hardware locking
  • 🖥️ Machine Locking: License tied to unique hardware fingerprint (UUID + MAC + disk serial)
  • Grace Period: 1-day free trial on first import, then license required
  • 🧪 CLI Tool: Easy license generation, activation, and validation
  • 🛡️ Feature Gating: Control access to specific package features
  • 🔧 Developer Friendly: Development bypass with QUANTUMMETA_DEV=1

📦 Installation

pip install quantummeta-license

🚀 Quick Start

For End Users

  1. Activate a license (if you have one):
quantum-license activate /path/to/your/license.qkey
  1. Check license status:
quantum-license validate quantum-metalearn
  1. Use in your Python code:
from quantummeta_license import validate_or_grace

# This will either validate the license or start the 1-day grace period
validate_or_grace("quantum-metalearn")

For Package Developers

Integrate licensing into your QuantumMeta package:

from quantummeta_license import validate_or_grace, LicenseError

def my_premium_function():
    try:
        # Validate license with specific features
        validate_or_grace("my-quantum-package", required_features=["pro"])
        # Your premium functionality here
        return "Premium feature activated!"
    except LicenseError:
        return "This feature requires a Pro license."

🧪 CLI Commands

The quantum-license CLI provides these commands:

  • generate: Create a new license (admin use)
  • activate: Install a license file
  • validate: Check license status and features
  • info: Display system information

Examples

# Generate a license (admin only)
quantum-license generate --package quantum-metalearn --user user@example.com --features core,pro

# Activate a license
quantum-license activate license.qkey

# Validate specific package
quantum-license validate quantum-metalearn

# Show system info
quantum-license info

🔧 Development Mode

For development and testing, set the environment variable:

export QUANTUMMETA_DEV=1  # Unix/Linux/macOS
set QUANTUMMETA_DEV=1     # Windows

This bypasses license checks entirely.

📁 License Storage

Licenses are stored in:

  • Windows: %USERPROFILE%\.quantummeta\licenses\
  • macOS: ~/.quantummeta/licenses/
  • Linux: ~/.quantummeta/licenses/

Usage tracking is stored in:

  • ~/.quantummeta/usage_log.json

🧠 Package Integration

To integrate QuantumMeta License into your package:

from quantummeta_license import validate_or_grace, LicenseError

def __init_license():
    """Call this in your package's __init__.py"""
    try:
        validate_or_grace("your-package-name")
    except LicenseError as e:
        print(f"License Error: {e}")
        # Handle license error appropriately

# Call on package import
__init_license()

📚 Documentation

Full documentation is available at: https://quantummeta.github.io/quantummeta-license

🛡️ Security

  • All license files are encrypted with AES-256
  • Hardware fingerprinting prevents license sharing
  • Secure key derivation using PBKDF2
  • Optional Ed25519 digital signatures

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

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

🆘 Support


Made with ❤️ by the QuantumMeta Team

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

quantummeta_license-1.1.1.tar.gz (40.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

quantummeta_license-1.1.1-py3-none-any.whl (35.7 kB view details)

Uploaded Python 3

File details

Details for the file quantummeta_license-1.1.1.tar.gz.

File metadata

  • Download URL: quantummeta_license-1.1.1.tar.gz
  • Upload date:
  • Size: 40.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for quantummeta_license-1.1.1.tar.gz
Algorithm Hash digest
SHA256 27172de12c58cd1c94b82b25ff71e2d8240df44c73eef2ca1ce32db7d01cf5fe
MD5 b68af1dee96498acba05b5d7098ec822
BLAKE2b-256 d75a89037eb1072d08774c3f58945f36840fa467d04bad7aaeda1c6813621e3e

See more details on using hashes here.

File details

Details for the file quantummeta_license-1.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for quantummeta_license-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f3863a4d1b19d0ddc552d9255ce44ea3c9d2c4ce7915ffc6fea562cd5a779f2e
MD5 8b70841a4a76891246443d13ac8b9b61
BLAKE2b-256 901d7ec627f943630a6646772a55a384bd0fd2c162b4b6f5cdc6a4cc31722bc4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page