# Kaizen AI Framework
[](https://pypi.org/project/kailash-kaizen/)
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/Apache-2.0)
**Signature-based programming framework for enterprise AI workflows**
Kaizen is an AI framework built on the [Kailash SDK](https://github.com/Integrum-Global/kailash_python_sdk) that provides signature-based programming, automatic optimization, and enterprise-grade capabilities.
## Quick Navigation
### 📁 **Project Organization**
- **[/docs/](docs/)** - Technical documentation, architecture, and implementation guides
- **[/examples/](examples/)** - Working examples with complete implementations
- **[/adr/](adr/)** - Architecture Decision Records and technical rationale
- **[/tracking/](tracking/)** - Implementation progress and gap analysis
- **[/scripts/](scripts/)** - Development tools and validation utilities
- **[/src/](src/)** - Source code implementation
- **[/tests/](tests/)** - Comprehensive test suite
### 🎯 **Key Documents**
- **[CLAUDE.md](CLAUDE.md)** - Claude Code navigation and agent instructions
- **[docs/README.md](docs/README.md)** - Documentation hub with organized guides
- **[Multi-Modal API Reference](docs/reference/multi-modal-api-reference.md)** - Vision, audio, multi-modal APIs (**NEW** ✅)
- **[Integration Testing Guide](docs/development/integration-testing-guide.md)** - Real model validation best practices (**NEW** ✅)
- **[examples/README.md](examples/README.md)** - Example categories and usage patterns
- **[tracking/](tracking/)** - Current implementation status and roadmap
## Features
- **Signature Programming**: Declarative AI workflow definition
- **Enterprise Ready**: Built on proven Kailash infrastructure
- **Auto-Optimization**: ML-based prompt and workflow improvement
- **Multi-Modal AI**: Vision (Ollama/OpenAI), audio (Whisper), unified orchestration (Phases 0-4 ✅)
- **Production Scale**: Performance and reliability for enterprise use
- **Cost Tracking**: Monitor and optimize AI API usage with budget management
## Quick Start
```python
from kaizen import Kaizen
from kailash.runtime.local import LocalRuntime
# Initialize framework
kaizen = Kaizen()
# Create AI agent with signature-based programming
agent = kaizen.create_agent("text_processor", {
"model": "gpt-4",
"temperature": 0.7
})
# Execute with Core SDK runtime
runtime = LocalRuntime()
results, run_id = runtime.execute(agent.workflow.build())
```
## Installation
```bash
pip install kailash-kaizen
```
For development:
```bash
pip install kailash-kaizen[dev]
```
## Architecture
Kaizen is built ON the Kailash SDK, providing:
- Signature-based programming layer
- Enhanced AI nodes with optimization
- Enterprise memory and security features
- Seamless integration with DataFlow and Nexus
## Developer Experience
### Documentation Structure
- **Getting Started**: See [examples/README.md](examples/README.md) for quickstart patterns
- **Multi-Modal AI**: See [docs/reference/multi-modal-api-reference.md](docs/reference/multi-modal-api-reference.md) for vision, audio, and multi-modal APIs
- **Integration Testing**: See [docs/development/integration-testing-guide.md](docs/development/integration-testing-guide.md) for real model validation
- **Technical Details**: See [docs/README.md](docs/README.md) for comprehensive guides
- **Implementation Status**: See [tracking/](tracking/) for current progress and gaps
- **Architecture Decisions**: See [adr/](adr/) for design rationale and requirements
### Development Workflow
1. **Explore Examples**: Start with [examples/1-single-agent/](examples/1-single-agent/) for basic patterns
2. **Check Implementation**: Review [tracking/KAIZEN_GAPS_ANALYSIS.md](tracking/KAIZEN_GAPS_ANALYSIS.md) for current status
3. **Read Architecture**: Study [docs/KAIZEN_INTEGRATION_STRATEGY.md](docs/KAIZEN_INTEGRATION_STRATEGY.md) for framework integration
4. **Run Tests**: Use [scripts/test_examples_implementation.py](scripts/test_examples_implementation.py) for validation
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
## Links
- **Repository**: [GitHub](https://github.com/Integrum-Global/kailash_python_sdk)
- **Documentation**: [Full Documentation](https://github.com/Integrum-Global/kailash_python_sdk/tree/main/apps/kailash-kaizen/docs)
- **PyPI**: [kailash-kaizen](https://pypi.org/project/kailash-kaizen/)
- **Issues**: [Bug Reports & Feature Requests](https://github.com/Integrum-Global/kailash_python_sdk/issues)
## License
Apache-2.0 WITH Additional-Terms - See [LICENSE](LICENSE) for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/Integrum-Global/kailash_python_sdk",
"name": "kailash-kaizen",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "kailash, ai, agents, workflow, automation, signature-programming",
"author": "Kailash Team",
"author_email": "info@integrum.com",
"download_url": "https://files.pythonhosted.org/packages/4c/3b/964fd461e12e4df731854450554f9b2133a783943362d7705b95cc2ea388/kailash_kaizen-0.1.2.tar.gz",
"platform": null,
"description": "# Kaizen AI Framework\n\n[](https://pypi.org/project/kailash-kaizen/)\n[](https://www.python.org/downloads/)\n[](https://opensource.org/licenses/Apache-2.0)\n\n**Signature-based programming framework for enterprise AI workflows**\n\nKaizen is an AI framework built on the [Kailash SDK](https://github.com/Integrum-Global/kailash_python_sdk) that provides signature-based programming, automatic optimization, and enterprise-grade capabilities.\n\n## Quick Navigation\n\n### \ud83d\udcc1 **Project Organization**\n- **[/docs/](docs/)** - Technical documentation, architecture, and implementation guides\n- **[/examples/](examples/)** - Working examples with complete implementations\n- **[/adr/](adr/)** - Architecture Decision Records and technical rationale\n- **[/tracking/](tracking/)** - Implementation progress and gap analysis\n- **[/scripts/](scripts/)** - Development tools and validation utilities\n- **[/src/](src/)** - Source code implementation\n- **[/tests/](tests/)** - Comprehensive test suite\n\n### \ud83c\udfaf **Key Documents**\n- **[CLAUDE.md](CLAUDE.md)** - Claude Code navigation and agent instructions\n- **[docs/README.md](docs/README.md)** - Documentation hub with organized guides\n- **[Multi-Modal API Reference](docs/reference/multi-modal-api-reference.md)** - Vision, audio, multi-modal APIs (**NEW** \u2705)\n- **[Integration Testing Guide](docs/development/integration-testing-guide.md)** - Real model validation best practices (**NEW** \u2705)\n- **[examples/README.md](examples/README.md)** - Example categories and usage patterns\n- **[tracking/](tracking/)** - Current implementation status and roadmap\n\n## Features\n\n- **Signature Programming**: Declarative AI workflow definition\n- **Enterprise Ready**: Built on proven Kailash infrastructure\n- **Auto-Optimization**: ML-based prompt and workflow improvement\n- **Multi-Modal AI**: Vision (Ollama/OpenAI), audio (Whisper), unified orchestration (Phases 0-4 \u2705)\n- **Production Scale**: Performance and reliability for enterprise use\n- **Cost Tracking**: Monitor and optimize AI API usage with budget management\n\n## Quick Start\n\n```python\nfrom kaizen import Kaizen\nfrom kailash.runtime.local import LocalRuntime\n\n# Initialize framework\nkaizen = Kaizen()\n\n# Create AI agent with signature-based programming\nagent = kaizen.create_agent(\"text_processor\", {\n \"model\": \"gpt-4\",\n \"temperature\": 0.7\n})\n\n# Execute with Core SDK runtime\nruntime = LocalRuntime()\nresults, run_id = runtime.execute(agent.workflow.build())\n```\n\n## Installation\n\n```bash\npip install kailash-kaizen\n```\n\nFor development:\n```bash\npip install kailash-kaizen[dev]\n```\n\n## Architecture\n\nKaizen is built ON the Kailash SDK, providing:\n- Signature-based programming layer\n- Enhanced AI nodes with optimization\n- Enterprise memory and security features\n- Seamless integration with DataFlow and Nexus\n\n## Developer Experience\n\n### Documentation Structure\n- **Getting Started**: See [examples/README.md](examples/README.md) for quickstart patterns\n- **Multi-Modal AI**: See [docs/reference/multi-modal-api-reference.md](docs/reference/multi-modal-api-reference.md) for vision, audio, and multi-modal APIs\n- **Integration Testing**: See [docs/development/integration-testing-guide.md](docs/development/integration-testing-guide.md) for real model validation\n- **Technical Details**: See [docs/README.md](docs/README.md) for comprehensive guides\n- **Implementation Status**: See [tracking/](tracking/) for current progress and gaps\n- **Architecture Decisions**: See [adr/](adr/) for design rationale and requirements\n\n### Development Workflow\n1. **Explore Examples**: Start with [examples/1-single-agent/](examples/1-single-agent/) for basic patterns\n2. **Check Implementation**: Review [tracking/KAIZEN_GAPS_ANALYSIS.md](tracking/KAIZEN_GAPS_ANALYSIS.md) for current status\n3. **Read Architecture**: Study [docs/KAIZEN_INTEGRATION_STRATEGY.md](docs/KAIZEN_INTEGRATION_STRATEGY.md) for framework integration\n4. **Run Tests**: Use [scripts/test_examples_implementation.py](scripts/test_examples_implementation.py) for validation\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## Links\n\n- **Repository**: [GitHub](https://github.com/Integrum-Global/kailash_python_sdk)\n- **Documentation**: [Full Documentation](https://github.com/Integrum-Global/kailash_python_sdk/tree/main/apps/kailash-kaizen/docs)\n- **PyPI**: [kailash-kaizen](https://pypi.org/project/kailash-kaizen/)\n- **Issues**: [Bug Reports & Feature Requests](https://github.com/Integrum-Global/kailash_python_sdk/issues)\n\n## License\n\nApache-2.0 WITH Additional-Terms - See [LICENSE](LICENSE) for details.\n",
"bugtrack_url": null,
"license": "Apache-2.0 WITH Additional-Terms",
"summary": "Advanced AI agent framework built on Kailash SDK",
"version": "0.1.2",
"project_urls": {
"Documentation": "https://docs.kailash.com/kaizen",
"Homepage": "https://github.com/Integrum-Global/kailash_python_sdk",
"Issues": "https://github.com/Integrum-Global/kailash_python_sdk/issues",
"Repository": "https://github.com/Integrum-Global/kailash_python_sdk"
},
"split_keywords": [
"kailash",
" ai",
" agents",
" workflow",
" automation",
" signature-programming"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "15774d7e8dcc32c6381334dae856ac35901f6582ae91f91709afea3c2f55fff4",
"md5": "842fe03474673f54a6624ea309300a61",
"sha256": "be121d47723eecbababfe64503c7321237664a99808d61d1abbad26187bb4b5e"
},
"downloads": -1,
"filename": "kailash_kaizen-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "842fe03474673f54a6624ea309300a61",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 628231,
"upload_time": "2025-10-06T05:09:50",
"upload_time_iso_8601": "2025-10-06T05:09:50.311837Z",
"url": "https://files.pythonhosted.org/packages/15/77/4d7e8dcc32c6381334dae856ac35901f6582ae91f91709afea3c2f55fff4/kailash_kaizen-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4c3b964fd461e12e4df731854450554f9b2133a783943362d7705b95cc2ea388",
"md5": "0b014d1d1efa3d7f73a47c532ae07193",
"sha256": "54ed17a286a6d0dfe1be117b8c323a018e01d18317eed716c9d39b167d6a1760"
},
"downloads": -1,
"filename": "kailash_kaizen-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "0b014d1d1efa3d7f73a47c532ae07193",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 2104412,
"upload_time": "2025-10-06T05:09:52",
"upload_time_iso_8601": "2025-10-06T05:09:52.285841Z",
"url": "https://files.pythonhosted.org/packages/4c/3b/964fd461e12e4df731854450554f9b2133a783943362d7705b95cc2ea388/kailash_kaizen-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-06 05:09:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Integrum-Global",
"github_project": "kailash_python_sdk",
"github_not_found": true,
"lcname": "kailash-kaizen"
}