omnipkg v1.4.0: The Liberation Update - No Redis Required!

This is a landmark release for omnipkg, fundamentally transforming its accessibility and ease of use. The biggest barrier to entry has been demolished: omnipkg no longer requires Redis to run!

Thanks to a new, fully-featured SQLite backend that acts as a seamless fallback, anyone can now get the full power of omnipkg with a simple pip install, no external services required. This makes first-time use, local development, and CI/CD integration trivially easy.

This version is the culmination of intense debugging and hardening, resulting in the most robust and accessible version of omnipkg ever released.

🚀 Major New Features

1. Robust SQLite Backend (Zero-Dependency Mode)

• No Redis, No Problem: If a Redis connection isn't available, omnipkg now automatically and seamlessly falls back to using a local SQLite database file for its knowledge base.
• Fully Featured: The new backend emulates the Redis API, supporting all of omnipkg's advanced features, including bubbling, version tracking, and self-healing sync.
• Instant Setup: This makes omnipkg 100% self-contained out of the box, perfect for new users and automated environments.

2. Hardened 8pkg run for Complex Orchestration

• The 8pkg run command has been significantly improved to handle complex, multi-process orchestrator scripts.
• Fixed the critical "split brain" context issue where subprocesses (like omnipkg swap) would lose track of the main environment's knowledge base.
• The command now ensures a unified and predictable environment context is passed to all child processes, allowing scripts to reliably manipulate different Python versions and package states.

🛠️ Bug Fixes & Stability Improvements

• Resolved Core Import Error: Corrected an ImportError (OmnipkgCore vs omnipkg) that occurred during the automatic interpreter re-launch process.

🧪 For Developers

• The multiverse_analysis.py stress test now passes flawlessly when launched with 8pkg run, serving as the ultimate validation of omnipkg's context switching, package management, and auto-healing capabilities working in perfect harmony.

How to Upgrade

pip install --upgrade omnipkg

This was a huge effort to hunt down and destroy some of the most subtle and complex bugs in the system. The result is a tool that is not only more powerful but dramatically easier for everyone to use. Thank you for your support!

omnipkg v1.3.11: The Unbreakable Engine Release

This is the release where omnipkg achieves architectural perfection. After a series of legendary debugging sessions, the core engine has been refactored to be leaner, smarter, and more portable than ever before, solidifying its status as a professional-grade, production-ready tool.

✨ Highlights

• 🚀 The Unbreakable Binary Engine: The hard dependency on python-magic has been eliminated. omnipkg now features a new, multi-strategy binary detection engine that uses a cascade of techniques—file permissions, magic number header inspection, and filename heuristics—to robustly identify executables even in the most sterile environments. This is a masterpiece of resilient engineering.

• 💎 Leaner, Faster Core: By making python-magic and tqdm optional, the core omnipkg installation is now smaller and faster for everyone. Power users can still get the "deluxe" experience with pip install omnipkg[full], while all users benefit from a leaner core.

• 🏆 True noarch Purity: This architectural change allows omnipkg to be packaged as a single, universal noarch: python package for Conda. This is the gold standard of portability, dramatically simplifying the release process and ensuring a single, reliable build works for all users on all platforms.

This release represents the final polish on a revolutionary tool. The engine is unbreakable. The vision is complete.

omnipkg v1.3.10: The Conda-Forge Conquest

omnipkg v1.3.10: The Conda-Forge Conquest

This is a monumental release. After a legendary battle with linters, build environments, and the fundamental laws of CI/CD, omnipkg has been officially accepted into Conda-Forge, the most trusted and respected repository in the scientific Python ecosystem.

This victory solidifies omnipkg's position as a truly multi-platform, production-grade tool, now available to millions of developers and data scientists via a simple, trusted command.

✨ Highlights

• 🏆 Now Available on Conda-Forge! You can now install omnipkg from the official conda-forge channel, the gold standard for Conda packages:

  conda install -c conda-forge omnipkg

• 🛡️ Bulletproof CI/CD Pipeline: The final, subtle bugs in the multi-platform build process have been hunted down and eliminated. The automated release factory now flawlessly builds and tests omnipkg on Linux, macOS, and Windows without human intervention.
• 💎 The Perfected Conda Recipe: The meta.yaml has been meticulously crafted to pass the rigorous conda-forge linter checks while correctly handling all platform-specific dependencies, resulting in a perfect build on every OS.

This release marks the completion of the omnipkg distribution empire. From pip to Docker to Homebrew and now to Conda-Forge, omnipkg is everywhere.

omnipkg v1.3.9: The CI/CD Hardening Release

omnipkg v1.3.9: The CI/CD Hardening Release

This is a critical follow-up release that perfects our automated, multi-platform release pipeline.

A subtle bug was discovered where the conda-build process would fail during the test phase. The test command was inadvertently triggering the full application startup, which requires a Redis connection that isn't available in a sterile build environment.

This release fixes the issue by implementing a more intelligent test command (omnipkg --version) that validates the installation without initializing the full application core.

With this fix, the entire release factory is now complete and battle-hardened. Pushing a new release will now automatically and flawlessly build and deploy omnipkg to:

• PyPI
• Docker Hub (multi-architecture)
• GitHub Container Registry (multi-architecture)
• Homebrew
• Conda (multi-platform)

The vision of a fully automated, zero-friction release process is now a reality.

omnipkg v1.3.8: The Futurist Release

omnipkg v1.3.8: The Futurist Release

This release officially introduces support for the bleeding-edge Python 3.13, solidifying omnipkg as the most forward-looking and resilient package manager in the ecosystem.

Thanks to a robust, multi-layered download engine and a clean, modern codebase, omnipkg was found to be forward-compatible with Python 3.13 out of the box. This version officializes that support.

✨ Highlights

• 🚀 Day-Zero Python 3.13 Support: Use omnipkg python adopt 3.13 to seamlessly download, install, and bootstrap the latest version of Python into your multiverse. Jump into the future of Python development today!
• Future-Proof by Design: This release proves that omnipkg's architecture is so sound that it can adapt to future Python versions with minimal changes.
• Official PyPI Declaration: The pyproject.toml has been updated to officially declare Python 3.13 compatibility, ensuring the broader community can install and use it with confidence.

omnipkg v1.3.7: The Sentient Engine Release

omnipkg v1.3.7: The Sentient Engine Release

This is the release where omnipkg wakes up.

We are proud to introduce a set of revolutionary features that elevate omnipkg from an intelligent package manager to a sentient development environment. This release is the culmination of a legendary debugging journey, resulting in a system that doesn't just manage dependencies—it anticipates, diagnoses, and heals them in real-time, enabling workflows that were previously impossible in Python.

🚀 The "It Just Works" Button: The Auto-Healing run Command

The new 8pkg run <your_script.py> command is the ultimate expression of our vision. It creates a self-improving system that refuses to let your script fail due to environment issues.

1. Execute: It first attempts to run your script at maximum speed using uv.
2. Diagnose: If the script fails—from a simple ModuleNotFoundError to a deep, catastrophic ABI break like the NumPy 2.0 incompatibility—omnipkg intercepts the crash and intelligently diagnoses the root cause.
3. Heal: It formulates a surgical healing plan, automatically installing the missing package or, in the case of a conflict, installing the correct version while bubbling the problematic one.
4. Retry: It then automatically re-runs your script in the now-perfected environment until it succeeds.

The first time you run a script, omnipkg learns and permanently fixes its environment. Every run after that is pure, unadulterated speed.

🤯 The Multiverse Unleashed: Bubbles Now Work in Subprocesses!

This is the groundbreaking feature that unlocks the true power of bubbles. We have solved the holy grail of environment isolation:

The Problem: A script running inside a bubble was isolated from the omnipkg library itself, preventing it from launching subprocesses that could also use omnipkg's magic.

The Genius Fix: The omnipkgLoader is now self-aware. When it activates a bubble, it surgically symlinks its own critical dependencies into that bubble.

This seemingly simple change has universe-altering implications, enabling:

• True Concurrent A/B Testing: Launch two subprocesses from the same script, each running a different version of TensorFlow in its own bubble, at the same time.
• Nested Bubbles: A script running in one bubble can now launch a child process that activates a completely different bubble.
• Complex Cross-Interpreter Workflows: A Python 3.11 script can now orchestrate a Python 3.9 subprocess that uses its own Python 3.9-specific bubbles.

The barriers between environments have been shattered. The multiverse is now yours to command.

---

This is it. The vision is complete. Welcome to the future of Python development.

omnipkg v1.3.6: The Purity & Transparency Release

Release Notes: omnipkg v1.3.6: The Purity & Transparency Release

This is a critical follow-up release that hardens and refines the revolutionary engine introduced in v1.3.5. After a marathon debugging session, the core engine has been meticulously refactored to eliminate technical debt and provide the user with complete trust and visibility.

This release focuses on two key principles: Code Purity and Operational Transparency.

✨ Highlights

• Code Purity & Maintainability:

  • A deep analysis of the codebase was performed to identify and purge all duplicated, legacy function definitions.
  • This significant refactoring has removed hundreds of lines of dead code, resulting in a slimmer, faster, and more robust core engine that is easier to maintain and build upon.

• Full Operational Transparency:

  • Never be in the dark during an install again! The internal pip calls within omnipkg install and omnipkg uninstall have been completely re-implemented.
  • They now provide live, unbuffered, streaming output, showing you every line from pip in real-time. You can now see package downloads, dependency resolution, and cache information exactly as it happens, giving you complete confidence in the process.

🛠️ What This Means

While v1.3.5 delivered the "magic," v1.3.6 makes that magic reliable, trustworthy, and ready for production. The codebase is now as clean and efficient as the solutions it provides.

omnipkg v1.3.5: The Purity & Performance Release

omnipkg v1.3.5: The Purity & Performance Release

This isn't just an update; it's a revolution. Version 1.3.5 marks the culmination of a legendary debugging saga, transforming omnipkg from a powerful tool into a truly intelligent, self-healing, and astonishingly robust development environment.

We have hunted down and eliminated a cascade of deep, interconnected bugs related to environment contamination, state management, and context switching. The result is a system that is not only correct but is now measurably faster than pip for cached installs, achieving the ultimate vision: a tool that JUST. WORKS.

The era of environment hell is over. Welcome to the future of Python development.

🚀 Highlights

• 🧠 Total Environment Purity: omnipkg is now hyper-aware of its context and completely immune to shell contamination. Stale $PATH variables, incorrect VIRTUAL_ENV settings, and conflicting conda vs venv setups are now handled with paranoid precision, eliminating a whole class of "works on my machine" bugs.
• 🌀 Flawless Context Switching: The omnipkg swap command is now battle-hardened and rock-solid. The multiverse engine can now teleport between Python dimensions (3.9, 3.11, etc.) with perfect reliability, making cross-version testing and development a seamless reality.
• 🚀 Faster Than Pip: Through relentless optimization and the power of its Redis-backed knowledge base, omnipkg now resolves satisfied dependencies faster than a raw pip install check. You get a massive intelligence layer at a negative performance cost.
• 🛡️ The Auto-Healing run Command: The omnipkg run command has been battle-tested and proven. It can now take a script that would fail in any other environment, catch ModuleNotFoundError, intelligently install the missing package, and automatically retry until the script succeeds.

🛠️ Detailed Fixes & Enhancements

This release represents a foundational rewrite of the core engine's stability.

• Core Engine (core.py):

  • CRITICAL FIX: The ConfigManager._get_venv_root logic has been completely overhauled. It now intelligently validates environment variables against the running executable, correctly prioritizing VIRTUAL_ENV and CONDA_PREFIX to prevent context hijacking.
  • CRITICAL FIX: All internal subprocesses used to interrogate different Python interpreters now run in isolated mode (-I), preventing PYTHONPATH contamination and ensuring child processes can't be corrupted by the parent's state.
  • FIX: The InterpreterManager now correctly sources its environment path from the hardened ConfigManager, resolving the final bug that prevented swaps from succeeding within scripts.

• Testing (multiverse_analysis.py):

  • The multiverse analysis test has been perfected into a lean, powerful orchestrator that now correctly uses omnipkg install and passes flawlessly, proving the end-to-end stability of the entire system.

• Version Control:

  • The Git history has been surgically repaired. The orphaned v1.3.4 commit and tag are now correctly integrated into the main branch, ensuring a clean and professional project history.

The Bottom Line

This is the release where the vision becomes reality. omnipkg is now the tool that lets you simply write code. It handles the environments, it handles the dependencies, it handles the conflicts, and it does it all faster and more reliably than ever before.

omnipkg v1.3.4: The Intelligence and Isolation Update

Release v1.3.4: The Intelligence and Isolation Update

This is a landmark release for omnipkg, fundamentally enhancing the tool's intelligence, reliability, and testability. Version 1.3.4 introduces a sophisticated, multi-stage version resolver that prevents installation failures before they happen. To validate this, we've also built a powerful "multiverse" testing suite that proves omnipkg's ability to manage complex, conflicting dependencies across multiple Python interpreters simultaneously.

✨ Features

🚀 Advanced Version Resolver

The installer is now significantly smarter. When a package is requested without a version, omnipkg now follows a super-optimized, multi-stage process to find the latest compatible version, ensuring installations succeed where they would have previously failed.

• ⚡️ Jackpot Path: If the latest version from PyPI is already installed, omnipkg now detects this instantly and skips all further checks for maximum speed.
• 🔬 Quick Compatibility Check: A new, lightweight pip install --dry-run check is performed first. This allows omnipkg to fail fast and intelligently parse compatibility errors without needing a full temporary installation.
• 🧠 Intelligent Error Parsing: If the latest version is incompatible, omnipkg now reads pip's error output to find the list of all available compatible versions and automatically selects the latest one.
• 🛡️ Robust Fallback: The original, highly-robust temporary installation with early-success detection is retained as a final fallback, guaranteeing a result.

🧪 Comprehensive "Multiverse" Testing Suite

omnipkg now includes a suite of advanced integration tests that validate its most powerful features in complex, real-world scenarios:

• Multi-Python Orchestration: Tests can now automatically switch between different managed Python interpreters (e.g., 3.9, 3.10, 3.11) within a single script run.
• Proven Dependency Isolation: The test suite proves that omnipkg can install different, conflicting versions of the same package (e.g., rich==13.4.2 in Python 3.9, rich==13.7.1 in Python 3.11) without them interfering with each other or the core omnipkg dependencies.

⚡️ Performance

• The new resolver logic significantly speeds up installations by avoiding temporary installs whenever possible.
• Tests now demonstrate the best practice of "pinning" versions (omnipkg install package==1.2.3) for CI/CD, resulting in near-instantaneous dependency checks.
• The omnipkgLoader's activation and deactivation of bubbles has been benchmarked and confirmed to operate in microseconds, providing virtually zero runtime overhead.

This release marks a major step towards making omnipkg a rock-solid, intelligent, and incredibly performant environment manager.

omnipkg v1.3.3: The Stability & Accuracy Patch

omnipkg v1.3.3: The Stability & Accuracy Patch

This is a significant patch release focused on improving the accuracy, stability, and user experience of the omnipkg toolchain. It addresses a critical bug in the security scanner, enhances the real-time output of the run command, and refactors the advanced multiverse_analysis test for greater reliability.

🐛 Bug Fixes

• Fixed Security Scanner False Positives: The security scanner would previously report "1 potential issues" even when a scan found zero vulnerabilities. This was due to a bug in how the JSON output from the safety tool was parsed. The parser has been completely rewritten to be more intelligent and robust, correctly identifying the vulnerabilities and report_meta fields in the report. As a result, scans now report the accurate number of issues, eliminating false positives and increasing user trust.
  • Before: ✅ Security scan complete. Found 1 potential issues. (Incorrect)
  • After: ✅ Security scan complete. Found 0 potential issues. (Correct)

🚀 Improvements & Refinements

• Enhanced Real-Time Output for run Command: The 8pkg run command's output is now fully unbuffered and streamed line-by-line with an immediate flush. This completely eliminates the "hanging" or "stuck" feeling during long-running installations or scripts, providing a much smoother, more responsive, and transparent user experience.

• Improved Reliability of Multiverse Analysis Test: The internal logic of the advanced multiverse_analysis.py test has been refactored for better clarity and stability. The "swap-then-act" pattern for preparing dimensional contexts is now more explicit and robust, ensuring that package installations and Knowledge Base updates happen reliably within the correct Python context. This makes the demonstration of omnipkg's most powerful features even more solid.

• Stabilized UV Switching Test: The test_uv_switching.py demo has been corrected to use the omnipkgLoader API properly, making the test fully stable and removing all warnings and errors.

How to Upgrade

To get the latest fixes, simply upgrade via pip:

pip install --upgrade omnipkg