Release v0.2.2 - Critical Package Fix π¨
β οΈ CRITICAL FIX - v0.2.1 was Non-Functional
If you installed v0.2.1, please upgrade immediately:
pip install --upgrade kubeagenticπ What Was Broken in v0.2.1
- β Only 3 files packaged (out of 28 required files)
- β All submodules missing (api, config, core, llm, middleware, session, tools, utils)
- β Package completely non-functional - All imports failed with
ModuleNotFoundError - β Unable to create agents or use any features
β What's Fixed in v0.2.2
- β All 28 files now included in the package
- β All 8 submodules packaged correctly
- β All imports working as expected
- β Package fully functional - Tested on PyPI
- β
Added regression test script (
build_and_test.sh)
π§ Technical Details
Root Cause: Incorrect setuptools configuration in pyproject.toml
Before (Broken):
[tool.setuptools]
packages = ["kubeagentic"] # Only top-level packageAfter (Fixed):
[tool.setuptools.packages.find]
where = ["."]
include = ["kubeagentic*"] # Auto-discovers all subpackages
exclude = ["tests*", "docs*", "*.egg-info"]π¦ Installation
Fresh Install
pip install kubeagenticUpgrade from v0.2.1
pip install --upgrade kubeagenticVerify Installation
import kubeagentic
print(kubeagentic.__version__) # Should print: 0.2.2
# Test imports
from kubeagentic.core import Agent, AgentConfig
from kubeagentic.config import ConfigParser
from kubeagentic.llm.factory import LLMFactory
from kubeagentic.api.app import create_app
# All should work without errors!π Package Comparison
| Metric | v0.2.1 (Broken) | v0.2.2 (Fixed) |
|---|---|---|
| Files Packaged | 3 | 28 |
| Submodules | 0 | 8 |
| Functional | β | β |
| All Imports Work | β | β |
π― What's Included
All submodules now available:
- β
kubeagentic.api- REST API server (5 files) - β
kubeagentic.config- Configuration parsing (4 files) - β
kubeagentic.core- Agent implementation (3 files) - β
kubeagentic.llm- LLM providers (3 files) - β
kubeagentic.middleware- API middleware (2 files) - β
kubeagentic.session- Session management (3 files) - β
kubeagentic.tools- Tool execution (3 files) - β
kubeagentic.utils- Utilities (2 files)
π Quick Start
from kubeagentic.core import Agent
from kubeagentic.config import ConfigParser
# Parse YAML configuration
config = ConfigParser.parse_file("agent.yaml")
# Create and use agent
agent = Agent(config)
response = agent.invoke("Hello!")
print(response)π Links
- π¦ PyPI Package: https://pypi.org/project/kubeagentic/0.2.2/
- π Documentation: https://kubeagentic.com/guides
- π Website: https://kubeagentic.com
- π Issues: https://github.com/KubeAgentic-Community/kubeagenticpkg/issues
- π¬ Discussions: https://github.com/KubeAgentic-Community/kubeagenticpkg/discussions
π Full Changelog
Fixed:
- π Package now includes all submodules (api, config, core, llm, middleware, session, tools, utils)
- π Fixed
pyproject.tomlto usepackages.findfor auto-discovery
Added:
- β¨
build_and_test.sh- Comprehensive test script to verify package integrity - β¨ Test verification in clean virtual environment
Changed:
- π§ Updated
.gitignoreto excludetest_venv/ - π§ Version bumped from 0.2.1 to 0.2.2
π₯ Contributors
- KubeAgentic Team
π Thank You
Thank you for your patience during this critical fix. We've added comprehensive testing to prevent similar issues in the future.
Full Commit: afa0257