devopsmind 1.1.1

Hands-on, DevOps learning platform with real labs and local sandbox execution.

🧠 DevOpsMind — Gamified DevOps Learning Simulator

🏷️ Latest Release: Continuously evolving — Free · Local · User-Owned · Forever

DevOpsMind is an offline-first, CLI-based, gamified DevOps simulator. Solve real DevOps tasks, validate your solutions, earn XP, unlock ranks, and build muscle memory with hands-on DevOps workflows.

You don’t watch DevOps.
You practice DevOps.

Part of the InfraForgeLabs open DevOps innovation ecosystem.

---

🔐 Official Ownership & Identity

InfraForge is an open-source infrastructure automation and DevSecOps platform developed and maintained by InfraForge Labs.

🌐 Official Website: https://devopsmind.infraforgelabs.in

🏢 Organization: https://infraforgelabs.in

---

🎥 Gameplay Demo

---

📘 Table of Contents

• About This Project
• Repository Overview
• Quick Start
• Features
• Deployment Options
• Integrations
• Contribution
• Roadmap
• Support

---

✨ Features

• 🎮 50 curated DevOps labs (10 stacks × 5 difficulty levels)

• 🎮 Gamified progression — XP, ranks, badges, and achievements
• 🖥️ CLI-first experience — learn where DevOps actually runs
• 📴 Offline-first by design — no internet required to learn
• 🌐 Optional online mode — secure sync and global leaderboard
• 🔐 Privacy-respecting — progress stored locally, snapshots encrypted

Core principle: Learn DevOps by Playing DevOps.

---

🔒 Offline-First Philosophy

DevOpsMind works fully without internet.

• All labs run locally
• Progress is stored on your machine
• Validation never depends on cloud services

Online features are optional and include:

• Secure progress sync
• Global leaderboard
• Cross-device recovery

You stay in control at all times.

---

🚀 Who Is This For?

• Students learning DevOps hands-on
• Engineers sharpening real-world skills
• Self-learners who prefer practice over theory
• Teams running offline labs or workshops

No subscriptions.
No cloud lock-in.
No hidden requirements.

---

🚀 Installation Matrix

OS	Recommended Method	Notes
Ubuntu/Debian	pipx	Best experience (isolated Python)
Fedora/RHEL	pip	Works natively
macOS	pipx via Homebrew Python	Perfect cross-platform setup
Windows	pipx (or WSL preferred)	Use WSL for best compatibility
WSL	pipx	Recommended Linux experience

---

🧩 Installation Method — pipx (Official)

1️⃣ Prerequisites

Install Python 3.9+ and pipx

Ubuntu / Debian

sudo apt update && sudo apt install -y python3 python3-venv python3-pip pipx
pip install --user pipx
pipx ensurepath

Fedora / RHEL / CentOS

sudo dnf install -y python3 python3-pip git

sudo ln -s "$HOME"/.local/bin/devopsmind /usr/local/bin/devopsmind

macOS (with Homebrew)

brew install python3 pipx
pipx ensurepath

Windows (PowerShell)

py -m pip install --user pipx
py -m pipx ensurepath

---

2️⃣ Install DevOpsMind via pipx

pipx install devopsmind

• (remove the pip install fallback to avoid confusion — pipx is your locked official method.)

---

3️⃣ Verify Installation

devopsmind version
devopsmind stacks

---

4️⃣ Update to the Latest Version

pipx upgrade devopsmind

• (remove the pip upgrade fallback to avoid confusion — pipx is your locked official method.)

---

5️⃣ Uninstall (if needed)

pipx uninstall devopsmind

• (remove the pip uninstall fallback to avoid confusion — pipx is your locked official method.)

---

🧠 Notes

• pipx ensures your DevOpsMind installation stays isolated from system Python.
• Works perfectly across Linux, macOS, and WSL.

---

📦 Progress Portability via Snapshots

DevOpsMind stores progress as local snapshots fully owned by the user. These snapshots can be copied to another machine and restored manually, allowing users to continue their learning journey without accounts or mandatory cloud sync.

Publishing progress to the public leaderboard is optional and never affects local snapshots, recovery, or offline usage.

---

🔐 Authoritative vs Public Data

Authoritative progress (local snapshots)

• Stored locally on the user’s machine
• Includes full lab state, XP, achievements, and history
• Used for recovery and continuity
• Remains fully under user control

Public leaderboard data

• Aggregated and non-authoritative
• Contains only XP, rank, and completion counts
• Cannot be used to restore or synchronize progress

Local snapshots are the single source of truth. Public leaderboard data is informational only.

---

🧭 Quickstart

DevOpsMind is offline‑first. You can learn, play, and validate labs without internet. Online features are optional and fully under your control.

---

1️⃣ Create your profile (optional but recommended)

devopsmind login

• Creates your local profile
• Enables optional cloud sync
• Required for leaderboards

To return to offline‑only mode:

devopsmind logout

---

2️⃣ Choose your mode (offline / online)

DevOpsMind works offline by default.

devopsmind mode offline

Offline mode:

• Learn & validate labs
• Progress stored locally
• No network usage

Enable online mode anytime:

devopsmind mode online

Online mode:

• Secure progress sync
• Global leaderboard access
• Restore progress on new devices

💡 Learning always works — mode only affects syncing.

---

3️⃣ View all available stacks

devopsmind stacks

---

4️⃣ Filter labs by stack

devopsmind --stack docker

or search directly:

devopsmind search docker

---

5️⃣ Play a lab

devopsmind play basic_dockerfile

This creates a local workspace for the lab.

---

6️⃣ Need help? Read the description or hint

devopsmind describe basic_dockerfile
devopsmind hint basic_dockerfile

Hints unlock automatically after multiple failed attempts.

---

7️⃣ Validate your work

devopsmind validate basic_dockerfile

On success:

• XP is awarded
• Achievements unlock
• Progress is synced (if online)

---

8️⃣ Check your progress and XP

devopsmind stats

---

9️⃣ Submit score to the global leaderboard (online only)

devopsmind submit

ℹ️ Requires devopsmind mode online

Your private progress remains encrypted. Only public leaderboard data is shared.

---

🔟 View achievements

devopsmind badges

---

1️⃣1️⃣ Global leaderboard

devopsmind leaderboard

Shows:

• Global rankings
• Your pinned position
• XP & rank tiers

---

🔐 Advanced: Recovery & Security (Optional)

DevOpsMind never stores your password locally.

A recovery key is used to restore your progress if needed.

Rotate recovery key

devopsmind auth rotate-recovery

Use this if:

• Your recovery key was exposed
• You want to improve account security

⚠️ Store your recovery key safely. Losing it may prevent account recovery.

---

✅ That’s It

You can now:

• Learn DevOps fully offline
• Sync safely when you choose
• Earn XP, badges, and ranks
• Compete globally without sacrificing privacy

Free · Local · Offline‑First · Secure · Optional Cloud

🌐 Live Leaderboard

• You can view the real-time global leaderboard for DevOpsMind here:

🌍 Live Site: https://devopsmind.infraforgelabs.in 🧱 Backup (GitHub Pages): https://infraforgelabs.github.io/DevOpsMind/

• This leaderboard is automatically updated whenever players complete labs and submit progress via the DevOpsMind CLI.

---

📚 Stacks Covered

• 🐧 Linux
• 💻 Bash
• 🌱 Git
• 🐍 Python
• ⚙️ Ansible
• 🐳 Docker
• ☸️ Kubernetes
• 🛳 Helm
• 🌍 Terraform
• 📈 Networking

---

🏗 Project Architecture

DevOpsMind/
├── src/devopsmind/              # Core CLI engine
│   ├── cli.py                   # CLI entry
│   ├── engine.py                # Lab execution engine
│   ├── play.py                  # Run labs
│   ├── progress.py              # XP, ranks, completion state
│   ├── snapshot.py              # Snapshot-based recovery & portability
│   ├── leaderboard.py           # Optional public leaderboard publishing
│   ├── update_check.py          # Version update detection
│   ├── validator.py             # Lab validation framework
│   └── achievements/            # Ranks, difficulty, stacks metadata
│
├── src/devopsmind/labs/   # Lab packs
│   ├── Linux/
│   ├── Bash/
│   ├── Git/
│   ├── Python/
│   ├── Ansible/
│   ├── Docker/
│   ├── K8s/
│   ├── Helm/
│   ├── Terraform/
│   └── Networking/
│       └── Easy | Medium | Hard | Expert | Master
│
├── devopsmind-relay/            # Optional leaderboard relay (publish-only)
│   └── index.js
│
├── docs/                        # Images & diagrams
│   ├── roadmap.png
│   ├── banner.png
│   └── ArchitectureDiagram.png
│
├── vision/                      # Long-term project docs
│   ├── CHANGELOG.md
│   ├── PHILOSOPHY.md
│   ├── STRATEGY.md
│   └── BUSINESS_MODEL.md
│
├── scripts/
│   └── bootstrap.sh             # Local setup helpers
│
├── README.md
├── LICENSE
└── pyproject.toml

---

🛣 Roadmap

---

📘 Vision & Governance

These documents define the learning philosophy, strategy, and long-term roadmap of DevOpsMind, guiding its evolution from CLI simulator to offline Studio suite.

File	Description
PHILOSOPHY	Educational vision, core learning values, and open philosophy
STRATEGY	Development roadmap from CLI → Sandbox → Studio → AI
BUSINESS_MODEL	Open education model and community-driven sustainability
CHANGELOG	Full version roadmap (2026–2032) with release milestones

---

🤝 Contributing

Pull requests welcome! Ensure validators remain deterministic.

---

📜 License

MIT License © 2025 InfraForgeLabs

---

💖 Support & Sponsorship

DevOpsMind is proudly built and maintained by InfraForge Labs as an open-source gamified DevOps learning platform.

If you find this project valuable — whether you’re learning, teaching, or building with it — consider supporting its development.
Your contribution helps keep DevOpsMind updated, free, and community-driven.

☕ Ways to Support

• 💎 GitHub Sponsors: https://github.com/sponsors/gauravchile
• ☕ Buy Me a Coffee: https://buymeacoffee.com/gauravchile

Every contribution — a coffee ☕, a star ⭐, or a pull request 🧩 — helps keep DevOpsMind alive, growing, and improving for everyone.

---

⭐ Support & Credits

Developed & maintained by Gaurav Chile

Founder, InfraForgeLabs

💡 DevOpsMind is fully modular — lab packs, validators, and installers auto-update via GitHub. Ideal for DevOps learners, professionals, teams, and training environments.

---