{"id":24531784,"url":"https://github.com/jvc-byte/pyvm","last_synced_at":"2025-03-15T20:15:43.658Z","repository":{"id":272081189,"uuid":"915468350","full_name":"jvc-byte/pyvm","owner":"jvc-byte","description":"A lightweight Python version manager that allows you to install, manage, and switch between different Python versions on Windows.","archived":false,"fork":false,"pushed_at":"2025-01-18T01:25:17.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-22T09:16:21.531Z","etag":null,"topics":["python-version-manager","python-version-manager-for-windows"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jvc-byte.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-11T23:12:37.000Z","updated_at":"2025-01-18T01:25:18.000Z","dependencies_parsed_at":"2025-01-12T00:23:36.121Z","dependency_job_id":"64d23515-1002-4dd1-9fff-87d0f37f46c3","html_url":"https://github.com/jvc-byte/pyvm","commit_stats":null,"previous_names":["jvc-byte/pvm"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvc-byte%2Fpyvm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvc-byte%2Fpyvm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvc-byte%2Fpyvm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvc-byte%2Fpyvm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jvc-byte","download_url":"https://codeload.github.com/jvc-byte/pyvm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243785083,"owners_count":20347409,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python-version-manager","python-version-manager-for-windows"],"created_at":"2025-01-22T09:16:26.586Z","updated_at":"2025-03-15T20:15:43.636Z","avatar_url":"https://github.com/jvc-byte.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Python Version Manager for Windows (PyVM)\n\nA lightweight Python version manager that allows you to install, manage, and switch between different Python versions on Windows.\n\n## Features\n\n- Install multiple Python versions side by side\n- Switch between installed Python versions easily\n- Manage Python versions through simple commands\n- Automatically handles PATH environment variables\n- Clean uninstallation of Python versions\n\n## Prerequisites\n\n- Windows operating system\n- Administrator privileges (required for PATH manipulation)\n- Internet connection (for downloading Python versions)\n- Git installed on your system\n- Python installed on your PC \n\n## Installation\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/YOUR_USERNAME/pyvm.git\n   cd pyvm\n   ```\n\n2. Run your first command to verify installation:\n   ```bash\n   python pyvm.py\n   ```\n\n3. (Optional) Add to PATH:\n   - Add the pyvm directory to your system's PATH\n   - Or create a shortcut in a directory that's already in your PATH\n\n## Usage\n\n### Important: Always run commands with administrator privileges\n\nRight-click on PowerShell or Command Prompt and select \"Run as administrator\" before executing any PyVM commands.\n\n### Basic Commands\n\n1. View available commands:\n   ```bash\n   python pyvm.py\n   ```\n\n2. List installed Python versions:\n   ```bash\n   python pyvm.py list\n   ```\n\n3. Install a specific Python version:\n   ```bash\n   python pyvm.py install 3.9.0\n   ```\n\n4. Switch to an installed Python version:\n   ```bash\n   python pyvm.py use 3.9.0\n   ```\n\n5. Uninstall a Python version:\n   ```bash\n   python pyvm.py uninstall 3.9.0\n   ```\n\n### Step-by-Step Example\n\n1. First time setup:\n   ```bash\n   # Open PowerShell as Administrator\n   git clone https://github.com/YOUR_USERNAME/pyvm.git\n   cd pyvm\n   python pyvm.py list  # Will show no versions installed\n   ```\n\n2. Install your first Python version:\n   ```bash\n   python pyvm.py install 3.9.0\n   # Wait for installation to complete\n   ```\n\n3. Switch to the installed version:\n   ```bash\n   python pyvm.py use 3.9.0\n   ```\n\n4. Verify the active Python version:\n   ```bash\n   python --version\n   ```\n\n## Directory Structure\n\nPyVM creates the following directory structure in your user home folder:\n\n```\n~/.pyvm/\n├── versions/\n│   ├── 3.9.0/\n│   ├── 3.8.0/\n│   └── ...\n└── config.json\n\nRepository Structure:\npyvm/\n├── pyvm.py\n├── README.md\n├── LICENSE\n└── .gitignore\n```\n\n## Troubleshooting\n\n1. \"Access Denied\" errors:\n   - Make sure you're running PowerShell or Command Prompt as Administrator\n\n2. Python version not found after switching:\n   - Close and reopen your terminal\n   - Verify PATH environment variable is updated\n   - Check if the version is properly installed using `pyvm list`\n\n3. Download failures:\n   - Check your internet connection\n   - Verify the Python version exists on python.org\n   - Try running the command again\n\n4. PATH issues:\n   - Check if multiple Python installations exist in PATH\n   - Verify the registry changes were successful\n   - Log out and log back in to refresh environment variables\n\n## Limitations\n\n- Only supports 64-bit Python versions\n- Requires administrator privileges\n- Windows-only support\n- Internet connection required for installation\n- Does not support beta/alpha versions\n\n## Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n\u003c!-- # Justin Anazor was here... \n# Samuel Okereafor was here ... --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjvc-byte%2Fpyvm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjvc-byte%2Fpyvm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjvc-byte%2Fpyvm/lists"}