# DevOps AI Toolkit

<div align="center">

<p align="center">
    <img src="assets/images/logo.jpeg" alt="DevOps AI Toolkit Logo" width="400">
</p>

[![npm version](https://badge.fury.io/js/%40vfarcic%2Fdot-ai.svg)](https://www.npmjs.com/package/@vfarcic/dot-ai)
[![npm downloads](https://img.shields.io/npm/dm/@vfarcic/dot-ai.svg)](https://www.npmjs.com/package/@vfarcic/dot-ai)
[![GitHub release](https://img.shields.io/github/release/vfarcic/dot-ai.svg)](https://github.com/vfarcic/dot-ai/releases/latest)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
![Project Status](https://img.shields.io/badge/status-beta-orange)
[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/vfarcic/dot-ai/badge)](https://scorecard.dev/viewer/?uri=github.com/vfarcic/dot-ai)
[![GitHub stars](https://img.shields.io/github/stars/vfarcic/dot-ai.svg?style=social&label=Star)](https://github.com/vfarcic/dot-ai)

</div>

**AI-powered platform engineering and DevOps automation through intelligent Kubernetes operations and conversational workflows.**

---

<div align="center">

## [AI Engine Docs](https://devopstoolkit.ai/docs/ai-engine/) | [MCP Setup](https://devopstoolkit.ai/docs/mcp/)

</div>

---

## Overview

DevOps AI Toolkit brings AI-powered intelligence to platform engineering, Kubernetes operations, and development workflows. Access it through [MCP](https://devopstoolkit.ai/docs/mcp/) for AI coding assistants or the [CLI](https://devopstoolkit.ai/docs/cli) for direct agent integration.

**Key capabilities:**
- Natural language cluster querying and exploration
- Intelligent Kubernetes deployment recommendations
- AI-powered issue remediation and root cause analysis
- Organizational pattern and policy management
- Semantic search over organizational documentation
- Automated repository setup with governance files
- Shared prompt libraries for consistent workflows

## Deployment

> **For the easiest setup**, we recommend installing the complete dot-ai stack which includes all components pre-configured. See the [Stack Installation Guide](https://devopstoolkit.ai/docs/stack).

For individual component installation, see the **[Deployment Guide](https://devopstoolkit.ai/docs/ai-engine/setup/deployment/)**.

[AI Engine Docs](https://devopstoolkit.ai/docs/ai-engine/) | [MCP Setup](https://devopstoolkit.ai/docs/mcp/)

## Support

- **[Support Guide](SUPPORT.md)** - How to get help and where to ask questions
- **GitHub Issues**: [Bug reports and feature requests](https://github.com/vfarcic/dot-ai/issues)
- **GitHub Discussions**: [Community Q&A and discussions](https://github.com/vfarcic/dot-ai/discussions)

## Contributing & Governance

We welcome contributions from the community! Please review:

- **[Contributing Guidelines](CONTRIBUTING.md)** - How to contribute code, docs, and ideas
- **[Code of Conduct](CODE_OF_CONDUCT.md)** - Community standards and expectations
- **[Security Policy](SECURITY.md)** - How to report security vulnerabilities
- **[Governance](docs/GOVERNANCE.md)** - Project governance and decision-making
- **[Maintainers](docs/MAINTAINERS.md)** - Current project maintainers
- **[Roadmap](docs/ROADMAP.md)** - Project direction and priorities

## License

MIT License - see [LICENSE](LICENSE) file for details.

## Telemetry

This project collects anonymous usage analytics to improve the product. [Learn more or opt out](https://devopstoolkit.ai/docs/ai-engine/operations/telemetry/).

## Acknowledgments

DevOps AI Toolkit is built on:
- [Model Context Protocol](https://modelcontextprotocol.io/) for AI integration framework
- [Vercel AI SDK](https://sdk.vercel.ai/) for unified AI provider interface
- [Kubernetes](https://kubernetes.io/) for the cloud native foundation
- [CNCF](https://www.cncf.io/) for the cloud native ecosystem

---

**DevOps AI Toolkit** - Making cloud native operations accessible through AI-powered intelligence.