devops-maturity 0.3.0

A tool to evaluate and measure the maturity level of your DevOps practices.

DevOps Maturity Assessment

Overview

DevOps Maturity Assessment helps you evaluate and improve your DevOps practices.

It provides both a web UI and a CLI, built on the DevOps Maturity Specification — a standardized set of guidelines for DevOps best practices.

🎥 Demo

Explore how the DevOps Maturity Assessment works in both interfaces:

• Web App Demo on YouTube
• CLI Demo on YouTube

Features

• Interactive CLI: Perform assessments directly from your terminal.
• Web Interface: Easy-to-use web app for taking assessments and viewing results.
• Maturity Scoring: Receive a maturity score, level, and badge based on your answers.
• Progress Tracking: View your assessment history to monitor improvement over time.
• Customizable Criteria: Adapt the assessment to fit your organization’s specific needs.
• Open Source: Built with Python and open to community contributions.

Quick Start

Run the CLI

Install from PyPI and start the interactive assessment:

pip install devops-maturity

# Start the assessment
devops-maturity assess

# Or use the shortcut command
dm assess

[!TIP] dm is a convenient alias for devops-maturity, making it quicker to type.

You'll be guided through a series of questions and receive a maturity score, level, and badge. See it in action:

Launch the Web Interface

To preview the web interface locally:

git clone https://github.com/devops-maturity/devops-maturity.git
cd devops-maturity
pip install nox
nox -s preview

Then visit http://127.0.0.1:8000 in your browser.

Web Interface Preview

Experience the full web interface workflow:

1. Start Your Assessment

2. View Your Results

3. Track Assessment History

Configuration

OAuth Setup (Optional)

To enable Google and GitHub OAuth login for the web interface:

1. Copy the example environment file:

   cp .env.example .env
   

2. For Google OAuth:

   • Go to Google Cloud Console
   • Create OAuth 2.0 credentials
   • Set authorized redirect URI to: http://localhost:8000/auth/callback/google
   • Copy the client ID and secret to your .env file

3. For GitHub OAuth:

   • Go to GitHub Developer Settings
   • Create a new OAuth app
   • Set authorization callback URL to: http://localhost:8000/auth/callback/github
   • Copy the client ID and secret to your .env file

If OAuth credentials are not configured, users can still register and login with username/password.

Show Your Support

If you find this tool helpful, please consider giving it a ⭐️ — your support helps others discover and adopt it.

Want to show your project aligns with the DevOps Maturity Specification? Add this badge to your README:

[![DevOps Maturity](https://img.shields.io/badge/DevOps%20Maturity%20Specification-1.0.0-yellow)](https://devops-maturity.github.io/)

Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.

• 📖 Read our Contributing Guide for detailed instructions
• 🐛 Report bugs or suggest features via GitHub Issues
• 💬 Join discussions in GitHub Discussions
• 🔒 Security: See our Security Policy for reporting vulnerabilities
• 📋 Governance: Learn about our project governance in GOVERNANCE.md

License

This project is licensed under the Apache License 2.0.