first commit

README.md

@@ -0,0 +1,102 @@
+# Portable Mamba
+
+A portable Miniforge installation script that creates isolated Python environments without modifying system settings.
+
+## Features
+
+- **Portable**: No system installation or registry changes
+- **Multiple Environments**: One installation can manage multiple environments
+- **Requirements Support**: Automatic package installation from requirements.txt
+- **Flexible Python Versions**: Specify any Python version
+- **Clean**: Minimal console output
+
+## Usage
+
+### Basic Usage
+
+```powershell
+# Create default environment (Python 3.9)
+.\portable.ps1
+```
+
+### Advanced Usage
+
+```powershell
+# Create specific environment
+.\portable.ps1 -EnvName myproject -PythonVersion 3.11
+
+# With requirements file
+.\portable.ps1 -EnvName webapp -PythonVersion 3.10 -RequirementsFile requirements.txt
+
+# Force recreate existing environment
+.\portable.ps1 -EnvName dataanalysis -Force
+
+# Create environment with custom requirements
+.\portable.ps1 -EnvName mlproject -PythonVersion 3.8 -RequirementsFile ml-requirements.txt
+```
+
+## Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `-EnvName` | string | "default" | Name of the environment |
+| `-PythonVersion` | string | "3.9" | Python version to install |
+| `-RequirementsFile` | string | "" | Path to requirements.txt file |
+| `-Force` | switch | false | Force recreation of existing environment |
+
+## Examples
+
+### Data Science Environment
+
+```powershell
+.\portable.ps1 -EnvName datascience -PythonVersion 3.11 -RequirementsFile data-science.txt
+```
+
+### Web Development Environment
+
+```powershell
+.\portable.ps1 -EnvName webdev -PythonVersion 3.10 -RequirementsFile web-requirements.txt
+```
+
+### Machine Learning Environment
+
+```powershell
+.\portable.ps1 -EnvName ml -PythonVersion 3.9 -RequirementsFile ml-requirements.txt
+```
+
+## File Structure
+
+After running the script, you'll have:
+
+```
+Miniforge-Portable/
+├── miniforge.exe
+├── portable.ps1
+├── mamba/                    # Miniforge installation
+│   ├── conda.exe
+│   ├── Scripts/
+│   └── envs/                 # Environments directory
+│       ├── default/
+│       ├── myproject/
+│       └── webapp/
+└── requirements.txt          # Your requirements file
+```
+
+## Requirements File Format
+
+Create a `requirements.txt` file with your Python packages:
+
+```
+numpy==1.24.3
+pandas==2.0.3
+matplotlib==3.7.1
+requests==2.31.0
+```
+
+## Notes
+
+- The script creates environments in `mamba/envs/` directory
+- Each environment is completely isolated
+- No system Python or conda installation required
+- Works on any Windows system with PowerShell
+- Environments persist between script runs