https://github.com/dev2forge/init-venv
Create Python virtual environment, install requirements, and activate with a single command
https://github.com/dev2forge/init-venv
automated-creation cli dev2forge python-venv python-virtual-environment tool
Last synced: 4 months ago
JSON representation
Create Python virtual environment, install requirements, and activate with a single command
- Host: GitHub
- URL: https://github.com/dev2forge/init-venv
- Owner: Dev2Forge
- License: gpl-3.0
- Created: 2025-07-18T23:33:22.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-08-13T23:04:30.000Z (4 months ago)
- Last Synced: 2025-08-14T01:06:03.608Z (4 months ago)
- Topics: automated-creation, cli, dev2forge, python-venv, python-virtual-environment, tool
- Language: C#
- Homepage:
- Size: 110 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# InitVenv
## Table of Contents
- [🚀 Features](#features)
- [📋 Requirements](#requirements)
- [🛠️ Installation](#installation)
- [📖 Usage](#usage)
- [🔧 How It Works](#how-it-works)
- [📸 Screenshots](#screenshots)
- [⚠️ Important Notes](#important-notes)
- [🤝 Contributing](#contributing)
- [📝 License](#license)
- [🔗 Links](#links)
- [👨💻 Contributors](#contributors)
**InitVenv** is a cross-platform automation tool that streamlines Python development workflow by automatically creating Python virtual environments, installing project dependencies from `requirements.txt`, and activating the environment with a single command execution. Currently supports Windows, with Linux and macOS support planned for future releases.
## Features
- **One-command setup**: Create Python virtual environment, install requirements, and activate with a single command
- **Windows integration**: Works seamlessly with Windows File Explorer
- **Automatic detection**: Finds and installs requirements from `requirements.txt` automatically
- **Path flexibility**: Supports both absolute and relative paths
- **Zero configuration**: Just run and go
## Requirements
- Python installed and added to system PATH
- Windows operating system (currently Windows-only)
## Installation
1. Download the latest [release](https://github.com/Dev2Forge/Init-Venv/releases)
2. Run the installer
3. The installer will:
- Copy `InitVenv-{architecture}.exe` and `InitVenv.bat` to your chosen directory
- Add the installation directory to system PATH
## Usage
### Method 1: Windows File Explorer (Recommended)
1. Navigate to your project directory using Windows File Explorer
2. Create a `requirements.txt` file with your Python dependencies
3. Press Ctrl + L to activate the address bar
4. Type `InitVenv` and press Enter
5. The program will automatically create the virtual environment and install dependencies
### Method 2: Command Line
```bash
InitVenv "C:\path\to\your\project"
```
You can use both absolute and relative paths:
```bash
InitVenv ".\my-project"
InitVenv ".."
```
## How It Works
The installer creates a simple batch file that launches the main executable:
```batch
@echo off
start "" "InitVenv-x64.exe" "%CD%"
exit
```
When you run `InitVenv`, it:
1. Detects the current directory
2. Creates a Python virtual environment (`.venv`)
3. Activates the virtual environment
4. Installs packages from `requirements.txt` (if present)
5. Keeps the terminal open for continued work
## Screenshots
| Scenario | Preview |
| :------- | :------ |
| Program startup error - missing working directory | 
|
| Successful program initialization without requirements file | 
|
| Console with virtual environment activated for user | 
|
| Program execution with requirements file installation | 
|
| User terminal session maintained after setup | 
|
## Important Notes
- The `requirements.txt` file must contain the dependencies **before** running InitVenv
- The program will not understand requirements once the virtual environment is created
- Currently supports Windows systems only
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
See the [Release Notes](https://github.com/Dev2Forge/Init-Venv/releases) for detailed development history and changelog.
## License
This project is licensed under the GPL-3.0 License - see the [LICENSE](LICENSE) file for details.
## Links
- [Download from SourceForge](https://sourceforge.net/projects/init-venv/)
- [GitHub Releases](https://github.com/Dev2Forge/Init-Venv/releases)
- [Issues](https://github.com/Dev2Forge/Init-Venv/issues)
- [Pull Requests](https://github.com/Dev2Forge/Init-Venv/pulls)
## Contributors
---
⭐ If you find this tool useful, please consider giving it a star!
