py-env-studio 2.0.8__tar.gz → 2.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (130) hide show
  1. py_env_studio-2.1.1/PKG-INFO +191 -0
  2. py_env_studio-2.1.1/PYPI_README.md +126 -0
  3. py_env_studio-2.0.8/PKG-INFO → py_env_studio-2.1.1/README.md +111 -90
  4. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/__main__.py +1 -1
  5. py_env_studio-2.1.1/py_env_studio/commands.py +432 -0
  6. py_env_studio-2.1.1/py_env_studio/config.ini +21 -0
  7. py_env_studio-2.1.1/py_env_studio/core/app_updates.py +94 -0
  8. py_env_studio-2.1.1/py_env_studio/core/configuration.py +301 -0
  9. py_env_studio-2.1.1/py_env_studio/core/database.py +102 -0
  10. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/env_manager.py +177 -34
  11. py_env_studio-2.1.1/py_env_studio/core/environment_lock.py +704 -0
  12. py_env_studio-2.1.1/py_env_studio/core/mcp/__init__.py +19 -0
  13. py_env_studio-2.1.1/py_env_studio/core/mcp/config.py +32 -0
  14. py_env_studio-2.1.1/py_env_studio/core/mcp/context.py +118 -0
  15. py_env_studio-2.1.1/py_env_studio/core/mcp/errors.py +21 -0
  16. py_env_studio-2.1.1/py_env_studio/core/mcp/schemas/__init__.py +7 -0
  17. py_env_studio-2.1.1/py_env_studio/core/mcp/schemas/responses.py +28 -0
  18. py_env_studio-2.1.1/py_env_studio/core/mcp/server.py +153 -0
  19. py_env_studio-2.1.1/py_env_studio/core/mcp/tools/__init__.py +116 -0
  20. py_env_studio-2.1.1/py_env_studio/core/mcp/tools/analysis.py +20 -0
  21. py_env_studio-2.1.1/py_env_studio/core/mcp/tools/environments.py +97 -0
  22. py_env_studio-2.1.1/py_env_studio/core/mcp/tools/packages.py +43 -0
  23. py_env_studio-2.1.1/py_env_studio/core/mcp/tools/project.py +156 -0
  24. py_env_studio-2.1.1/py_env_studio/core/mcp/tools/security.py +104 -0
  25. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/package_manager.py +97 -8
  26. py_env_studio-2.1.1/py_env_studio/core/package_update_monitor.py +162 -0
  27. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/pip_tools.py +48 -25
  28. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/plugins/base.py +3 -0
  29. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/plugins/manager.py +110 -15
  30. py_env_studio-2.1.1/py_env_studio/core/project_contract/__init__.py +37 -0
  31. py_env_studio-2.1.1/py_env_studio/core/project_contract/models.py +80 -0
  32. py_env_studio-2.1.1/py_env_studio/core/project_contract/repository.py +116 -0
  33. py_env_studio-2.1.1/py_env_studio/core/project_contract/service.py +361 -0
  34. py_env_studio-2.1.1/py_env_studio/core/project_intelligence/__init__.py +22 -0
  35. py_env_studio-2.1.1/py_env_studio/core/project_intelligence/models.py +235 -0
  36. py_env_studio-2.1.1/py_env_studio/core/project_intelligence/service.py +625 -0
  37. py_env_studio-2.1.1/py_env_studio/core/project_launcher.py +117 -0
  38. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/runtime.py +32 -8
  39. py_env_studio-2.1.1/py_env_studio/core/runtime_cache.py +585 -0
  40. py_env_studio-2.1.1/py_env_studio/core/runtime_providers.py +868 -0
  41. py_env_studio-2.1.1/py_env_studio/core/runtime_toggle.py +678 -0
  42. py_env_studio-2.1.1/py_env_studio/core/schema/__init__.py +95 -0
  43. py_env_studio-2.1.1/py_env_studio/core/schema/environment_locks.sql +37 -0
  44. py_env_studio-2.1.1/py_env_studio/core/schema/environments.sql +7 -0
  45. py_env_studio-2.1.1/py_env_studio/core/schema/migration.sql +21 -0
  46. py_env_studio-2.1.1/py_env_studio/core/schema/package_updates.sql +36 -0
  47. py_env_studio-2.1.1/py_env_studio/core/schema/project_contract.sql +45 -0
  48. py_env_studio-2.1.1/py_env_studio/core/schema/runtime_cache.sql +26 -0
  49. py_env_studio-2.1.1/py_env_studio/core/schema/schema_core.sql +28 -0
  50. py_env_studio-2.1.1/py_env_studio/core/schema/schema_runtime_cache.sql +22 -0
  51. py_env_studio-2.1.1/py_env_studio/core/schema/vulnerability.sql +21 -0
  52. py_env_studio-2.1.1/py_env_studio/core/templates/__init__.py +55 -0
  53. py_env_studio-2.1.1/py_env_studio/core/templates/builtin_templates.py +487 -0
  54. py_env_studio-2.1.1/py_env_studio/core/templates/community.py +268 -0
  55. py_env_studio-2.1.1/py_env_studio/core/templates/content_filters.py +87 -0
  56. py_env_studio-2.1.1/py_env_studio/core/templates/engine.py +274 -0
  57. py_env_studio-2.1.1/py_env_studio/core/templates/github_import.py +81 -0
  58. py_env_studio-2.1.1/py_env_studio/core/templates/models.py +70 -0
  59. py_env_studio-2.1.1/py_env_studio/core/templates/registry.py +57 -0
  60. py_env_studio-2.1.1/py_env_studio/core/templates/user_template_store.py +265 -0
  61. py_env_studio-2.1.1/py_env_studio/core/templates/validator.py +74 -0
  62. py_env_studio-2.1.1/py_env_studio/core/templates/workflow.py +55 -0
  63. py_env_studio-2.1.1/py_env_studio/core/tool_probe.py +60 -0
  64. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/tools.py +1 -0
  65. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/uv_tools.py +24 -5
  66. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/windows_apps.py +3 -9
  67. py_env_studio-2.1.1/py_env_studio/main.py +5 -0
  68. py_env_studio-2.1.1/py_env_studio/ui/main_window.py +5758 -0
  69. py_env_studio-2.1.1/py_env_studio/ui/status_bar.py +244 -0
  70. py_env_studio-2.1.1/py_env_studio/ui/ui_tasks.py +165 -0
  71. py_env_studio-2.1.1/py_env_studio/utils/app_icon.py +158 -0
  72. py_env_studio-2.1.1/py_env_studio/utils/app_logging.py +253 -0
  73. py_env_studio-2.1.1/py_env_studio/utils/db_status.py +155 -0
  74. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/utils/handlers.py +5 -15
  75. py_env_studio-2.1.1/py_env_studio/utils/progress.py +326 -0
  76. py_env_studio-2.1.1/py_env_studio/utils/version_utils.py +36 -0
  77. py_env_studio-2.1.1/py_env_studio/utils/vulneribility_insights.py +838 -0
  78. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/utils/vulneribility_scanner.py +14 -0
  79. py_env_studio-2.1.1/py_env_studio.egg-info/PKG-INFO +191 -0
  80. py_env_studio-2.1.1/py_env_studio.egg-info/SOURCES.txt +118 -0
  81. py_env_studio-2.1.1/py_env_studio.egg-info/entry_points.txt +4 -0
  82. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio.egg-info/requires.txt +2 -1
  83. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/pyproject.toml +12 -11
  84. py_env_studio-2.1.1/tests/test_environment_lock.py +364 -0
  85. py_env_studio-2.0.8/README.md +0 -194
  86. py_env_studio-2.0.8/py_env_studio/config.ini +0 -12
  87. py_env_studio-2.0.8/py_env_studio/core/configuration.py +0 -30
  88. py_env_studio-2.0.8/py_env_studio/core/database.py +0 -113
  89. py_env_studio-2.0.8/py_env_studio/main.py +0 -57
  90. py_env_studio-2.0.8/py_env_studio/ui/main_window.py +0 -1740
  91. py_env_studio-2.0.8/py_env_studio/utils/vulneribility_insights.py +0 -327
  92. py_env_studio-2.0.8/py_env_studio.egg-info/PKG-INFO +0 -261
  93. py_env_studio-2.0.8/py_env_studio.egg-info/SOURCES.txt +0 -59
  94. py_env_studio-2.0.8/py_env_studio.egg-info/entry_points.txt +0 -2
  95. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/LICENSE +0 -0
  96. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/__init__.py +0 -0
  97. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/__init__.py +0 -0
  98. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/auto_resolve.py +0 -0
  99. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/bootstrap.py +0 -0
  100. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/dependency_preview.py +0 -0
  101. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/integration.py +0 -0
  102. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/plugins/__init__.py +0 -0
  103. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/plugins/exceptions.py +0 -0
  104. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/py_tonic.py +0 -0
  105. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/setup_state.py +0 -0
  106. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/core/strategies.py +0 -0
  107. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/__init__.py +0 -0
  108. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/__init__.py +0 -0
  109. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/about.png +0 -0
  110. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/activate-env.png +0 -0
  111. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/available-env.png +0 -0
  112. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/create-env.png +0 -0
  113. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/delete-env.png +0 -0
  114. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/export.png +0 -0
  115. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/install.png +0 -0
  116. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/list-env.png +0 -0
  117. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/logo.png +0 -0
  118. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/packages.png +0 -0
  119. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/pes-default-transparrent.png +0 -0
  120. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/pes-icon-default.ico +0 -0
  121. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/pes-icon-default.png +0 -0
  122. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/pes-transparrent-icon-default.ico +0 -0
  123. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/requirements.png +0 -0
  124. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/selected-env.png +0 -0
  125. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/uninstall.png +0 -0
  126. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/ui/static/icons/update.png +0 -0
  127. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio/utils/__init__.py +0 -0
  128. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio.egg-info/dependency_links.txt +0 -0
  129. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/py_env_studio.egg-info/top_level.txt +0 -0
  130. {py_env_studio-2.0.8 → py_env_studio-2.1.1}/setup.cfg +0 -0
@@ -0,0 +1,191 @@
1
+ Metadata-Version: 2.4
2
+ Name: py-env-studio
3
+ Version: 2.1.1
4
+ Summary: A comprehensive cross-platform GUI and CLI tool for managing Python virtual environments and packages with advanced features including environment lifecycle management, package operations, vulnerability scanning, security insights, project templates, Py-Tonic interactive learning mode, an extensible plugin system for custom functionality, and a local read-only MCP control plane (beta) for AI coding agents.
5
+ Author-email: Py Env Studio Team <contact.shaikh.wasim@gmail.com>
6
+ License: MIT License
7
+
8
+ Copyright (c) 2025 pyenvstudio
9
+
10
+ Permission is hereby granted, free of charge, to any person obtaining a copy
11
+ of this software and associated documentation files (the "Software"), to deal
12
+ in the Software without restriction, including without limitation the rights
13
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
14
+ copies of the Software, and to permit persons to whom the Software is
15
+ furnished to do so, subject to the following conditions:
16
+
17
+ The above copyright notice and this permission notice shall be included in all
18
+ copies or substantial portions of the Software.
19
+
20
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
23
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
25
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
26
+ SOFTWARE.
27
+
28
+ Project-URL: Homepage, https://github.com/pyenvstudio/py-env-studio
29
+ Project-URL: Issues, https://github.com/pyenvstudio/py-env-studio/issues
30
+ Project-URL: Documentation, https://py-env-studio.readthedocs.io/en/latest/
31
+ Keywords: python,virtualenv,venv,conda,environment-manager,package-manager,dependency-manager,requirements.txt,pip,python-packages,python-gui,cli,virtual-environment-gui,pyenv,python-env,python-environment-manager,pip-gui,pip-manager,python-security,vulnerability-scanner,python-tool,cross-platform,IDE
32
+ Classifier: Development Status :: 5 - Production/Stable
33
+ Classifier: Intended Audience :: Developers
34
+ Classifier: Intended Audience :: System Administrators
35
+ Classifier: License :: OSI Approved :: MIT License
36
+ Classifier: Programming Language :: Python :: 3
37
+ Classifier: Programming Language :: Python :: 3.12
38
+ Classifier: Programming Language :: Python :: 3.13
39
+ Classifier: Operating System :: OS Independent
40
+ Classifier: Topic :: Software Development
41
+ Classifier: Topic :: Software Development :: Build Tools
42
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
43
+ Classifier: Topic :: System :: Installation/Setup
44
+ Classifier: Topic :: Utilities
45
+ Requires-Python: >=3.12
46
+ Description-Content-Type: text/markdown
47
+ License-File: LICENSE
48
+ Requires-Dist: customtkinter>=5.2.2
49
+ Requires-Dist: Pillow>=11.3.0
50
+ Requires-Dist: tkinter-dash>=0.1.5
51
+ Requires-Dist: cvss>=3.6
52
+ Requires-Dist: Requests
53
+ Requires-Dist: pip
54
+ Requires-Dist: setuptools
55
+ Requires-Dist: wheel
56
+ Requires-Dist: platformdirs>=4.2.0
57
+ Requires-Dist: packaging>=24.2
58
+ Provides-Extra: dev
59
+ Requires-Dist: pytest; extra == "dev"
60
+ Requires-Dist: black; extra == "dev"
61
+ Requires-Dist: isort; extra == "dev"
62
+ Provides-Extra: gui
63
+ Requires-Dist: Pillow; extra == "gui"
64
+ Dynamic: license-file
65
+
66
+ <p align="center">
67
+ <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/py_env_studio/ui/static/icons/pes-icon-default.png?raw=true" alt="Py Env Studio Logo" width="150">
68
+ </p>
69
+
70
+ # 🐍🏠 Py Env Studio
71
+
72
+ [![PyPI Version](https://img.shields.io/pypi/v/py-env-studio.svg?logo=pypi&logoColor=white)](https://pypi.org/project/py-env-studio/)
73
+ [![Python Versions](https://img.shields.io/pypi/pyversions/py-env-studio.svg?logo=python&logoColor=yellow)](https://pypi.org/project/py-env-studio/)
74
+ [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/pyenvstudio/py-env-studio/blob/main/LICENSE)
75
+ [![Documentation Status](https://readthedocs.org/projects/py-env-studio/badge/?version=latest)](https://py-env-studio.readthedocs.io/en/latest/?badge=latest)
76
+ [![GitHub Stars](https://img.shields.io/github/stars/pyenvstudio/py-env-studio?style=flat&logo=github)](https://github.com/pyenvstudio/py-env-studio/stargazers)
77
+ [![Open Issues](https://img.shields.io/github/issues/pyenvstudio/py-env-studio?logo=github)](https://github.com/pyenvstudio/py-env-studio/issues)
78
+
79
+ **Py Env Studio (PES)** is a cross-platform **Graphical Environment & Package
80
+ Manager for Python**: create and manage virtual environments, install and audit
81
+ packages, scan for vulnerabilities, scaffold projects from templates, and expose
82
+ a local, read-only **MCP control plane (beta)** for AI coding agents — from one
83
+ desktop app and a matching CLI.
84
+
85
+ Perfect for:
86
+
87
+ - ✅ Python beginners who want simplicity
88
+ - ✅ Data scientists setting up ML/DL stacks
89
+ - ✅ Developers managing Django, Flask, FastAPI projects
90
+ - ✅ Teams who need **secure, isolated environments**
91
+ - ✅ Power users wanting **plugin extensibility**
92
+
93
+ ## ✨ Highlights
94
+
95
+ - ➕ One-click virtual environment create, delete, activate, rename, and search
96
+ - 📦 Package management with selectable **pip** or **uv** backends
97
+ (automatic pip fallback), install/uninstall/update, import/export of
98
+ `requirements.txt`
99
+ - 🛡️ Environment vulnerability scanner with insights dashboard, plus
100
+ remediation actions (`Update Now`, `Upgrade all Packages`)
101
+ - 🧩 Project templates: built-in Python Script / CLI / Package templates, your
102
+ own local or GitHub templates, and GitHub **Community Templates** discovery
103
+ - ⚙️ Configuration center for default venv path, interpreter/runtime, package
104
+ manager, project tool, template defaults, appearance, and UI scaling
105
+ (the default venv path is read-only in the dialog; set `venv_dir` in
106
+ `config.ini` to relocate it)
107
+ - 🐍 Official **Python Install Manager** integration to detect, list, install,
108
+ and select official runtimes
109
+ - 🔌 Extensible **plugin system** with 18 lifecycle hooks
110
+ - 📟 Full CLI with progress gauge and `-v` / `-q` / `--no-progress` controls
111
+ - 🧪 **Beta:** local, read-only **MCP control plane** for AI coding agents
112
+ (stdio transport, 8 `pyenv_*` tools, opt-out via `enabled = false`)
113
+
114
+ ## 📥 Installation
115
+
116
+ ```bash
117
+ pip install py-env-studio
118
+ ```
119
+
120
+ Requires **Python 3.12+**. See the
121
+ [installation guide](https://py-env-studio.readthedocs.io/en/latest/getting-started/install.html)
122
+ for upgrade, extras, and uninstall steps.
123
+
124
+ ## 🚀 Quick start
125
+
126
+ Launch the GUI (no arguments opens the desktop application):
127
+
128
+ ```bash
129
+ py-env-studio
130
+ ```
131
+
132
+ The package installs three equivalent entry points — **`py-env-studio`**,
133
+ **`pes`**, and **`pyenvstudio`** — for both the GUI and every CLI command:
134
+
135
+ ```bash
136
+ py-env-studio --list # or: pes --list
137
+ py-env-studio --create myenv
138
+ py-env-studio --install myenv,numpy
139
+ pes run app.py # run a script inside a managed project
140
+ pes mcp # start the MCP control plane (beta, stdio)
141
+ ```
142
+
143
+ Full CLI reference:
144
+ [https://py-env-studio.readthedocs.io/en/latest/getting-started/cli.html](https://py-env-studio.readthedocs.io/en/latest/getting-started/cli.html)
145
+
146
+ ## 🧪 MCP control plane (beta)
147
+
148
+ Py Env Studio can expose a **local, read-only MCP server** so AI coding agents
149
+ (Copilot or any MCP client) consume authoritative Python environment state
150
+ instead of guessing it.
151
+
152
+ - **Read-only beta** — 8 tools covering environments, packages, dependencies,
153
+ cached vulnerabilities, project context, and an aggregate project report
154
+ - **Local-first** — stdio only, no ports, no network calls from MCP
155
+ - **Opt-out** — set `enabled = false` in the `[mcp]` section of `config.ini`
156
+
157
+ Setup steps for VS Code and other clients:
158
+ [https://py-env-studio.readthedocs.io/en/latest/reference/mcp.html](https://py-env-studio.readthedocs.io/en/latest/reference/mcp.html)
159
+
160
+ ## 📚 Documentation
161
+
162
+ - Documentation home: [https://py-env-studio.readthedocs.io/](https://py-env-studio.readthedocs.io/)
163
+ - Usage manual: [https://py-env-studio.readthedocs.io/en/latest/getting-started/usage.html](https://py-env-studio.readthedocs.io/en/latest/getting-started/usage.html)
164
+ - Release notes: [https://py-env-studio.readthedocs.io/en/latest/releases/v2.1.0.html](https://py-env-studio.readthedocs.io/en/latest/releases/v2.1.0.html)
165
+ - Source code: [https://github.com/pyenvstudio/py-env-studio](https://github.com/pyenvstudio/py-env-studio)
166
+ - Issue tracker: [https://github.com/pyenvstudio/py-env-studio/issues](https://github.com/pyenvstudio/py-env-studio/issues)
167
+
168
+ ## 🌐 Network access
169
+
170
+ PES uses public, read-only APIs (no authentication required). Ensure HTTPS
171
+ access to:
172
+
173
+ | Service | Purpose | URL |
174
+ |----------|----------|-----|
175
+ | PyPI | Package metadata | [pypi.org](https://pypi.org) |
176
+ | deps.dev | Dependency data | [deps.dev](https://deps.dev) |
177
+ | OSV.dev | Vulnerability info | [osv.dev](https://osv.dev) |
178
+ | Github | Community templates | [github.com](https://github.com) |
179
+
180
+ ## 🤝 Contributing
181
+
182
+ Contributions are welcome — fork the repository, raise issues, or submit pull
183
+ requests at [https://github.com/pyenvstudio/py-env-studio](https://github.com/pyenvstudio/py-env-studio).
184
+
185
+ ## ⚖️ License
186
+
187
+ This project is licensed under the MIT License — see
188
+ [https://github.com/pyenvstudio/py-env-studio/blob/main/LICENSE](https://github.com/pyenvstudio/py-env-studio/blob/main/LICENSE).
189
+
190
+ Py Env Studio — Simplifying Python environment management for everyone with a
191
+ built-in security scanner.
@@ -0,0 +1,126 @@
1
+ <p align="center">
2
+ <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/py_env_studio/ui/static/icons/pes-icon-default.png?raw=true" alt="Py Env Studio Logo" width="150">
3
+ </p>
4
+
5
+ # 🐍🏠 Py Env Studio
6
+
7
+ [![PyPI Version](https://img.shields.io/pypi/v/py-env-studio.svg?logo=pypi&logoColor=white)](https://pypi.org/project/py-env-studio/)
8
+ [![Python Versions](https://img.shields.io/pypi/pyversions/py-env-studio.svg?logo=python&logoColor=yellow)](https://pypi.org/project/py-env-studio/)
9
+ [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/pyenvstudio/py-env-studio/blob/main/LICENSE)
10
+ [![Documentation Status](https://readthedocs.org/projects/py-env-studio/badge/?version=latest)](https://py-env-studio.readthedocs.io/en/latest/?badge=latest)
11
+ [![GitHub Stars](https://img.shields.io/github/stars/pyenvstudio/py-env-studio?style=flat&logo=github)](https://github.com/pyenvstudio/py-env-studio/stargazers)
12
+ [![Open Issues](https://img.shields.io/github/issues/pyenvstudio/py-env-studio?logo=github)](https://github.com/pyenvstudio/py-env-studio/issues)
13
+
14
+ **Py Env Studio (PES)** is a cross-platform **Graphical Environment & Package
15
+ Manager for Python**: create and manage virtual environments, install and audit
16
+ packages, scan for vulnerabilities, scaffold projects from templates, and expose
17
+ a local, read-only **MCP control plane (beta)** for AI coding agents — from one
18
+ desktop app and a matching CLI.
19
+
20
+ Perfect for:
21
+
22
+ - ✅ Python beginners who want simplicity
23
+ - ✅ Data scientists setting up ML/DL stacks
24
+ - ✅ Developers managing Django, Flask, FastAPI projects
25
+ - ✅ Teams who need **secure, isolated environments**
26
+ - ✅ Power users wanting **plugin extensibility**
27
+
28
+ ## ✨ Highlights
29
+
30
+ - ➕ One-click virtual environment create, delete, activate, rename, and search
31
+ - 📦 Package management with selectable **pip** or **uv** backends
32
+ (automatic pip fallback), install/uninstall/update, import/export of
33
+ `requirements.txt`
34
+ - 🛡️ Environment vulnerability scanner with insights dashboard, plus
35
+ remediation actions (`Update Now`, `Upgrade all Packages`)
36
+ - 🧩 Project templates: built-in Python Script / CLI / Package templates, your
37
+ own local or GitHub templates, and GitHub **Community Templates** discovery
38
+ - ⚙️ Configuration center for default venv path, interpreter/runtime, package
39
+ manager, project tool, template defaults, appearance, and UI scaling
40
+ (the default venv path is read-only in the dialog; set `venv_dir` in
41
+ `config.ini` to relocate it)
42
+ - 🐍 Official **Python Install Manager** integration to detect, list, install,
43
+ and select official runtimes
44
+ - 🔌 Extensible **plugin system** with 18 lifecycle hooks
45
+ - 📟 Full CLI with progress gauge and `-v` / `-q` / `--no-progress` controls
46
+ - 🧪 **Beta:** local, read-only **MCP control plane** for AI coding agents
47
+ (stdio transport, 8 `pyenv_*` tools, opt-out via `enabled = false`)
48
+
49
+ ## 📥 Installation
50
+
51
+ ```bash
52
+ pip install py-env-studio
53
+ ```
54
+
55
+ Requires **Python 3.12+**. See the
56
+ [installation guide](https://py-env-studio.readthedocs.io/en/latest/getting-started/install.html)
57
+ for upgrade, extras, and uninstall steps.
58
+
59
+ ## 🚀 Quick start
60
+
61
+ Launch the GUI (no arguments opens the desktop application):
62
+
63
+ ```bash
64
+ py-env-studio
65
+ ```
66
+
67
+ The package installs three equivalent entry points — **`py-env-studio`**,
68
+ **`pes`**, and **`pyenvstudio`** — for both the GUI and every CLI command:
69
+
70
+ ```bash
71
+ py-env-studio --list # or: pes --list
72
+ py-env-studio --create myenv
73
+ py-env-studio --install myenv,numpy
74
+ pes run app.py # run a script inside a managed project
75
+ pes mcp # start the MCP control plane (beta, stdio)
76
+ ```
77
+
78
+ Full CLI reference:
79
+ [https://py-env-studio.readthedocs.io/en/latest/getting-started/cli.html](https://py-env-studio.readthedocs.io/en/latest/getting-started/cli.html)
80
+
81
+ ## 🧪 MCP control plane (beta)
82
+
83
+ Py Env Studio can expose a **local, read-only MCP server** so AI coding agents
84
+ (Copilot or any MCP client) consume authoritative Python environment state
85
+ instead of guessing it.
86
+
87
+ - **Read-only beta** — 8 tools covering environments, packages, dependencies,
88
+ cached vulnerabilities, project context, and an aggregate project report
89
+ - **Local-first** — stdio only, no ports, no network calls from MCP
90
+ - **Opt-out** — set `enabled = false` in the `[mcp]` section of `config.ini`
91
+
92
+ Setup steps for VS Code and other clients:
93
+ [https://py-env-studio.readthedocs.io/en/latest/reference/mcp.html](https://py-env-studio.readthedocs.io/en/latest/reference/mcp.html)
94
+
95
+ ## 📚 Documentation
96
+
97
+ - Documentation home: [https://py-env-studio.readthedocs.io/](https://py-env-studio.readthedocs.io/)
98
+ - Usage manual: [https://py-env-studio.readthedocs.io/en/latest/getting-started/usage.html](https://py-env-studio.readthedocs.io/en/latest/getting-started/usage.html)
99
+ - Release notes: [https://py-env-studio.readthedocs.io/en/latest/releases/v2.1.0.html](https://py-env-studio.readthedocs.io/en/latest/releases/v2.1.0.html)
100
+ - Source code: [https://github.com/pyenvstudio/py-env-studio](https://github.com/pyenvstudio/py-env-studio)
101
+ - Issue tracker: [https://github.com/pyenvstudio/py-env-studio/issues](https://github.com/pyenvstudio/py-env-studio/issues)
102
+
103
+ ## 🌐 Network access
104
+
105
+ PES uses public, read-only APIs (no authentication required). Ensure HTTPS
106
+ access to:
107
+
108
+ | Service | Purpose | URL |
109
+ |----------|----------|-----|
110
+ | PyPI | Package metadata | [pypi.org](https://pypi.org) |
111
+ | deps.dev | Dependency data | [deps.dev](https://deps.dev) |
112
+ | OSV.dev | Vulnerability info | [osv.dev](https://osv.dev) |
113
+ | Github | Community templates | [github.com](https://github.com) |
114
+
115
+ ## 🤝 Contributing
116
+
117
+ Contributions are welcome — fork the repository, raise issues, or submit pull
118
+ requests at [https://github.com/pyenvstudio/py-env-studio](https://github.com/pyenvstudio/py-env-studio).
119
+
120
+ ## ⚖️ License
121
+
122
+ This project is licensed under the MIT License — see
123
+ [https://github.com/pyenvstudio/py-env-studio/blob/main/LICENSE](https://github.com/pyenvstudio/py-env-studio/blob/main/LICENSE).
124
+
125
+ Py Env Studio — Simplifying Python environment management for everyone with a
126
+ built-in security scanner.
@@ -1,70 +1,3 @@
1
- Metadata-Version: 2.4
2
- Name: py-env-studio
3
- Version: 2.0.8
4
- Summary: A comprehensive cross-platform GUI and CLI tool for managing Python virtual environments and packages with advanced features including environment lifecycle management, package operations, vulnerability scanning, security insights, Py-Tonic interactive learning mode, and an extensible plugin system for custom functionality.
5
- Author-email: Py Env Studio Team <contact.shaikh.wasim@gmail.com>
6
- License: MIT License
7
-
8
- Copyright (c) 2025 pyenvstudio
9
-
10
- Permission is hereby granted, free of charge, to any person obtaining a copy
11
- of this software and associated documentation files (the "Software"), to deal
12
- in the Software without restriction, including without limitation the rights
13
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
14
- copies of the Software, and to permit persons to whom the Software is
15
- furnished to do so, subject to the following conditions:
16
-
17
- The above copyright notice and this permission notice shall be included in all
18
- copies or substantial portions of the Software.
19
-
20
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
23
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
25
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
26
- SOFTWARE.
27
-
28
- Project-URL: Homepage, https://github.com/pyenvstudio/py-env-studio
29
- Project-URL: Issues, https://github.com/pyenvstudio/py-env-studio/issues
30
- Keywords: python,virtualenv,venv,conda,environment-manager,package-manager,dependency-manager,requirements.txt,pip,python-packages,python-gui,cli,virtual-environment-gui,pyenv,python-env,python-environment-manager,pip-gui,pip-manager,python-security,vulnerability-scanner,python-tool,cross-platform,IDE
31
- Classifier: Development Status :: 5 - Production/Stable
32
- Classifier: Intended Audience :: Developers
33
- Classifier: Intended Audience :: System Administrators
34
- Classifier: License :: OSI Approved :: MIT License
35
- Classifier: Programming Language :: Python :: 3
36
- Classifier: Programming Language :: Python :: 3.8
37
- Classifier: Programming Language :: Python :: 3.9
38
- Classifier: Programming Language :: Python :: 3.10
39
- Classifier: Programming Language :: Python :: 3.11
40
- Classifier: Programming Language :: Python :: 3.12
41
- Classifier: Programming Language :: Python :: 3.13
42
- Classifier: Operating System :: OS Independent
43
- Classifier: Topic :: Software Development
44
- Classifier: Topic :: Software Development :: Build Tools
45
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
46
- Classifier: Topic :: System :: Installation/Setup
47
- Classifier: Topic :: Utilities
48
- Requires-Python: >=3.7
49
- Description-Content-Type: text/markdown
50
- License-File: LICENSE
51
- Requires-Dist: customtkinter>=5.2.2
52
- Requires-Dist: Pillow>=11.3.0
53
- Requires-Dist: matplotlib>=3.10.5
54
- Requires-Dist: cvss>=3.6
55
- Requires-Dist: Requests
56
- Requires-Dist: pip
57
- Requires-Dist: setuptools
58
- Requires-Dist: wheel
59
- Requires-Dist: platformdirs>=4.2.0
60
- Provides-Extra: dev
61
- Requires-Dist: pytest; extra == "dev"
62
- Requires-Dist: black; extra == "dev"
63
- Requires-Dist: isort; extra == "dev"
64
- Provides-Extra: gui
65
- Requires-Dist: Pillow; extra == "gui"
66
- Dynamic: license-file
67
-
68
1
  <p align="center">
69
2
  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/py_env_studio/ui/static/icons/pes-icon-default.png?raw=true" alt="Py Env Studio Logo" width="150">
70
3
  </p>
@@ -96,6 +29,29 @@ Perfect for:
96
29
 
97
30
  ---
98
31
 
32
+ ## 🆕 What's new in v2.1.0
33
+
34
+ - 🧪 **MCP control plane (beta)** — a local, read-only MCP server lets AI coding
35
+ agents (VS Code Copilot and other MCP clients) read authoritative
36
+ environment, package, dependency, security, and project state.
37
+ → [Setup steps](docs/reference/mcp.md)
38
+ - 🧩 **Project templates** — built-in Python Script / CLI / Package templates,
39
+ your own templates from a local folder or GitHub, and GitHub
40
+ **Community Templates** discovery.
41
+ - ⚙️ **Configuration center** (Tools → Configuration) — default venv path,
42
+ interpreter/runtime, package manager, project tool, template defaults,
43
+ appearance, and UI scaling in one validated dialog.
44
+ - 🐍 **Official Python Install Manager integration** — detect, list, install,
45
+ and select official runtimes, with System/Custom providers alongside.
46
+ - 🛡️ **Remediate from the dashboard** — `Update Now` per vulnerability and
47
+ `Upgrade all Packages` per environment, with partial-failure reporting.
48
+ - 📊 **Native dashboard charts** (`tkinter-dash`, no matplotlib), 📶 a CLI
49
+ progress gauge and GUI status gauge, and consistent application icons.
50
+
51
+ → [Full v2.1.0 release notes](docs/releases/v2.1.0.md)
52
+
53
+ ---
54
+
99
55
  ## 🌟 GUI Key Features
100
56
 
101
57
  - ➕ Create and delete virtual environments
@@ -144,12 +100,27 @@ Perfect for:
144
100
 
145
101
  PyEnvStudio now features a powerful plugin system that allows developers to extend functionality:
146
102
 
147
- - **17 Available Hooks** - Respond to environment and package operations
103
+ - **18 Available Hooks** - Respond to environment, package, application, and template operations
148
104
  - **State Management** - Plugins persist across application restarts
149
105
  - **Easy Development** - Simple plugin API with lifecycle management
150
106
  - **Examples Included** - Full working sample plugin with documentation
151
107
 
152
- See [RELEASE_NOTES.md](RELEASE_NOTES.md) for plugin system details and [docs/PLUGIN_DEVELOPMENT.md](docs/PLUGIN_DEVELOPMENT.md) for creating your own plugins.
108
+ See the [v2.1.0 release notes](docs/releases/v2.1.0.md) and the [plugin development guide](docs/plugins/development.md).
109
+
110
+ ### Additional implemented capabilities
111
+
112
+ - Selectable `pip` or `uv` package backends, with automatic `pip` fallback
113
+ - Dependency-impact preview and AutoResolver install recovery
114
+ - Project templates, reusable local/GitHub templates, and guided project creation
115
+ - Runtime-managed projects through `pes init`, `pes on`, `pes off`, and `pes run`
116
+ - Persisted configuration for default paths, interpreters, tools, package manager, themes, scaling, template defaults, and runtime provider
117
+ - Py-Tonic learning challenges and profile-based notifications
118
+ - GitHub Community Templates discovery with static preview before import
119
+ - Vulnerability remediation (`Update Now`, `Upgrade all Packages`) with native dashboard charts
120
+ - Informative CLI progress gauge plus `-v` / `-q` / `--no-progress` output controls
121
+ - 🧪 **Beta:** a local, read-only **MCP control plane** for AI coding agents
122
+
123
+ See [the complete feature reference](docs/reference/current-implementation.md), [the architecture overview](docs/reference/architecture.md), and the [MCP reference (beta)](docs/reference/mcp.md).
153
124
 
154
125
  ### 🛠️ Self-Healing Install System (AutoResolver)
155
126
 
@@ -162,6 +133,24 @@ PES now includes **AutoResolver**, a self-healing install system for pip/uv work
162
133
 
163
134
  Because when installs stop breaking, **PES finally means peace.🤗**
164
135
 
136
+ ## 🧪 MCP Control Plane (Beta)
137
+
138
+ Py Env Studio can expose a **local, read-only MCP server** so AI coding agents
139
+ (Copilot or any MCP client) consume authoritative Python environment state
140
+ instead of guessing it. PES is the infrastructure, not the model.
141
+
142
+ ```bash
143
+ py-env-studio mcp # stdio transport, no GUI, no network required
144
+ ```
145
+
146
+ - **Read-only beta** — 8 tools covering environments, packages, dependencies,
147
+ cached vulnerabilities, project context, and one aggregate project report.
148
+ - **Local-first** — stdio only, no ports, no network calls from MCP.
149
+ - **Opt-out** — set `enabled = false` in the `[mcp]` section of `config.ini`.
150
+
151
+ Setup steps for VS Code, portable client configs, the tool list, and
152
+ troubleshooting: [docs/reference/mcp.md](docs/reference/mcp.md).
153
+
165
154
  ## ☕ Support
166
155
 
167
156
  If you find **Py Env Studio** helpful, consider supporting me:
@@ -171,6 +160,9 @@ If you find **Py Env Studio** helpful, consider supporting me:
171
160
  [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20me-ff5e5b?logo=ko-fi&logoColor=white&style=for-the-badge)](https://ko-fi.com/contactshaikhwasim)
172
161
  [![PayPal](https://img.shields.io/badge/Donate-PayPal-blue?logo=paypal&style=for-the-badge)](https://www.paypal.me/paypalwasimshaikh)
173
162
 
163
+ <p align="center">
164
+ <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/bmc-qr-code.png?raw=true" alt="Buy Me a Coffee QR Code" width="200">
165
+ </p>
174
166
 
175
167
  ---
176
168
 
@@ -183,41 +175,69 @@ If you find **Py Env Studio** helpful, consider supporting me:
183
175
 
184
176
  py-env-studio
185
177
 
178
+ You can also launch the same utility with these aliases:
179
+
180
+ pyenvstudio
181
+ pes
182
+
183
+ The same aliases apply to every CLI command shown in the documentation
184
+ (`pes --list`, `pes mcp`, `pyenvstudio init`, …).
185
+
186
186
  Refer usage documentation here: https://py-env-studio.readthedocs.io/en/latest/
187
187
 
188
+ ## 📸 Screenshots
189
+
188
190
  <p align="center">
189
191
  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.environment-screen.PNG?raw=true" alt="Environment Screen" width="400">
190
-
191
- <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/plugin-screen.PNG?raw=true" alt="Plugin Screen" width="400">
192
+ <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.1.more_options.PNG?raw=true" alt="Environment More Options" width="400"><br>
193
+ <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.2.1_vulneribility_scan_report.PNG?raw=true" alt="Vulnerability Scan Report" width="400">
194
+ <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.2.2_vulneribility_scan_report.PNG?raw=true" alt="Vulnerability Scan Report Details" width="400"><br>
195
+ <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.2.3_vulneribility_scan_report.PNG?raw=true" alt="Vulnerability Scan Report Insights" width="400">
192
196
  <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/2.0.package-screen.PNG?raw=true" alt="Package Screen" width="400"><br>
193
- <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.2.1_vulneribility_scan_report.PNG?raw=true" alt="Package Screen" width="400">
194
- <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/1.2.2_vulneribility_scan_report.PNG?raw=true" alt="Package Screen" width="400">
197
+ <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/2.1.package-screen.PNG?raw=true" alt="Package Screen Details" width="400">
198
+ <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/plugin-screen.PNG?raw=true" alt="Plugin Screen" width="400"><br>
199
+ <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/templates.PNG?raw=true" alt="Templates Screen" width="400">
200
+ <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/python-manager.PNG?raw=true" alt="Python Manager Screen" width="400"><br>
201
+ <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/configuration.PNG?raw=true" alt="Configuration Screen" width="400">
202
+ <img src="https://github.com/pyenvstudio/py-env-studio/blob/main/screenshots/3.about-sceeen.PNG?raw=true" alt="About Screen" width="400">
195
203
  </p>
196
204
 
197
205
  **📁 Project Structure**
198
206
 
199
- py-env-studio/
207
+ py_env_studio/
200
208
  ├── __init__.py
201
- ├──resources
209
+ ├── commands.py # CLI flags, subcommands, output controls
210
+ ├── config.ini # packaged defaults (version, settings, [mcp])
211
+ ├── main.py # application entry helpers
202
212
  ├── core/
203
- │ ├── __init__.py
204
- │ ├── env_manager.py
205
- │ └── pip_tools.py
213
+ │ ├── env_manager.py # environment lifecycle and metadata
214
+ │ ├── package_manager.py # unified pip/uv routing
215
+ │ ├── pip_tools.py / uv_tools.py
216
+ │ ├── auto_resolve.py # dependency-conflict recovery
217
+ │ ├── dependency_preview.py # pre-install impact analysis
218
+ │ ├── configuration.py # preferences service
219
+ │ ├── runtime_toggle.py # managed project runtime (pes.config)
220
+ │ ├── runtime_providers.py # Python Install Manager / System / Custom
221
+ │ ├── project_intelligence.py # aggregate project report
222
+ │ ├── project_contract.py # pes.config contract service
223
+ │ ├── database.py + schema/ # SQLite manager and SQL templates
224
+ │ ├── mcp/ # beta read-only MCP server (stdio)
225
+ │ ├── plugins/ # plugin framework and hooks
226
+ │ └── templates/ # template engine, registry, user store
206
227
  ├── utils/
207
- │ ├── __init__.py
208
228
  │ ├── handlers.py
209
- │ └── vulneribility_scanner.py
210
- │ └── vulneribility_insights.py
229
+ │ ├── vulneribility_scanner.py
230
+ │ ├── vulneribility_insights.py
231
+ │ ├── app_logging.py / progress.py
232
+ │ └── version_utils.py
211
233
  ├── ui/
212
- │ ├── __init__.py
213
- │ └── main_window.py
214
- └── static/
215
- └── icons/
216
- ├── main.py
217
- ├── config.ini
218
- ├── requirements.txt
219
- ├── README.md
220
- └── pyproject.toml
234
+ │ ├── main_window.py # CustomTkinter application
235
+ │ ├── status_bar.py # activity text + progress gauge
236
+ │ ├── ui_tasks.py # background task helpers
237
+ │ └── static/icons/
238
+ └── main.py
239
+
240
+ docs/ · examples/ · tests/ · pyproject.toml · README.md
221
241
 
222
242
  **🚀 Roadmap**
223
243
 
@@ -240,6 +260,7 @@ This project uses public APIs for core features:
240
260
  | PyPI | Package metadata | [pypi.org](https://pypi.org) |
241
261
  | deps.dev | Dependency data | [deps.dev](https://deps.dev) |
242
262
  | OSV.dev | Vulnerability info | [osv.dev](https://osv.dev) |
263
+ | Github | Community templates | [github.com](https://github.com) |
243
264
 
244
265
  Ensure HTTPS access to these domains.
245
266
  APIs are public, read-only, no auth required.
@@ -1,4 +1,4 @@
1
- from .main import main
1
+ from .commands import main
2
2
 
3
3
  if __name__ == "__main__":
4
4
  main()