envhealth 0.1.0

Environment health checker that validates Python runtime, OS, dependencies, variables and system readiness

envhealth

Environment Health Checker for Python Projects

---

Features

• Detects Python version issues
• Detects dependency conflicts
• Checks RAM, CPU, OS info
• Detects GPU availability
• Generates:
  • Console Report
  • HTML Report
  • JSON Report
  • Markdown Report
• Colored terminal output
• Zero configuration

---

Installation

You can install envhealth via pip:

pip install envhealth

Usage

CLI Usage

• Run the environment checker in the console:

      envhealth
  

• Generate HTML, JSON, or Markdown reports:

      envhealth --html
      envhealth --json
      envhealth --markdown
  

• Combine multiple formats:

      envhealth --html --json --markdown
  

Programatic Usage

• Use envhealth in your Python scripts:

  from envhealth import EnvironmentChecker, ConsoleReporter, HTMLReporter, JSONReporter, MarkdownReporter
  
  # Run all checks
  checker = EnvironmentChecker()
  results = checker.run_all()
  
  # Console output
  ConsoleReporter().render(results)
  
  # Save reports
  HTMLReporter().save(results, path="env_report.html")
  JSONReporter().save(results, path="env_report.json")
  MarkdownReporter().save(results, path="env_report.md")
  

Sample Output

Console Output

    === PYTHON ENVIRONMENT HEALTH REPORT ===
    Generated: 2025-01-01 18:22:11
    ----------------------------------------

    Python:
    current_version: 3.11.7
    minimum_required: 3.8
    status: OK

    System:
    os: Linux
    os_release: 6.6.10
    cpu_count: 12
    ram_gb: 16.0

    GPU:
    Available: False

    Dependency Conflicts:
    None

    Warnings:
    None

TODO

• Roadmap
• CUDA performance check
• Internet & proxy diagnostics
• PDF export
• GUI dashboard / VS Code integration

License

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

⭐ Support

If you find this useful, please star the repository.