AI-powered, read-only DevOps troubleshooting for logs, YAML, Terraform, Kubernetes, OpenStack and more. One shared analysis engine powers a CLI, a Python SDK, and a REST API — so you get identical behaviour everywhere.
The toolkit is read-only: it inspects text and produces guidance. It never executes commands, mutates files, or touches your infrastructure. It is offline-first: a packaged knowledge base of YAML "signatures" does the analysis with no API key required. Optional LLM providers add narrative enrichment behind a vendor-agnostic adapter.
from devops_ai_toolkit import AnalysisEngine
result = AnalysisEngine().analyze_file("nova.log")
print(result.summary)pip install devops-ai-toolkit
devops-ai analyze nova.log
devops-ai explain CrashLoopBackOff- Getting started — the 5-minute overview
- Installation — core, API extra, and
uv-based dev installs - Quickstart — first analysis in CLI, SDK, and REST
- CLI guide — every
devops-aicommand - SDK guide —
AnalysisEnginefrom Python - REST API guide — HTTP endpoints and Swagger
- Configuration — environment variables and tunables
- AI providers — the adapter model (Anthropic/OpenAI/Gemini/Ollama)
- Output format — the result sections explained
- Supported technologies — what the knowledge base covers
- Use cases — real workflows
- Examples — copy-pasteable snippets
- Plugins — the plugin architecture: the
AnalyzerPlugininterface, discovery, lifecycle, and CLI/REST - Plugin development — scaffold, test, package, and publish a plugin
- Plugin marketplace — the
PluginMetadataschema and the registry vision - Enterprise plugins — private, signed, offline, and pinned plugins; the trust model
- LLM providers — the provider plugin point (Anthropic/OpenAI/Gemini/Azure/Ollama/null)
- Architecture — clean architecture and the shared engine
- Knowledge base — how signatures work and how to add one
- Security — read-only guarantees and key handling
- Comparison — vs. raw LLM chat and kubectl plugins
- Glossary — terms used throughout
- Troubleshooting guide — fixing the toolkit itself
- FAQ
- Contributing
- Developer guide
- Coding standards
- Testing guide
- Plugin guide — custom providers and signatures
- Release process
- Roadmap
- Website & tutorials: https://devopsaitoolkit.com
- Troubleshooting blog: https://devopsaitoolkit.com/blog
- AI incident assistant: https://devopsaitoolkit.com/dashboard/incident-response
- Newsletter: https://devopsaitoolkit.com/newsletter
MIT. See the repository for full text.