Python-NoAdmin

Bootstrap Python without administrator, root, or sudo access.

A cross-platform solution for developers working in restricted environments who need a fully functional Python runtime without elevated privileges.

Quick Start

Windows

install.cmd

macOS / Linux

chmod +x install.sh
./install.sh

That's it! The installer will:

1. Download a bootstrap Python (first run only)
2. Install your chosen Python version to ~/.python-nonadmin
3. Install pip
4. Configure your PATH

---

Advanced Usage

# Install specific version
./install.sh --version 3.11.9

# Force reinstall
./install.sh --force

# List available versions
./install.sh --list

# Uninstall
./install.sh --uninstall

Windows (PowerShell)

# All the same flags work
.\install.cmd --version 3.11.9
.\install.cmd --list
.\install.cmd --uninstall

---

Features

• No admin/sudo required – Installs entirely in user-writable directories
• Cross-platform – Works on Windows, macOS (Intel & Apple Silicon), and Linux (x86_64 & ARM64)
• Version selection – Install any supported Python version
• Complete Python – Includes pip and full standard library
• Virtual environment support – Create isolated environments as usual
• Self-contained – Uses bundled bootstrap Python, no dependencies

---

How It Works

┌─────────────────────────────────────────────────────────────┐
│  install.cmd / install.sh                                   │
│  ↓                                                          │
│  Downloads bootstrap Python to bin/python/ (first run)      │
│  ↓                                                          │
│  Runs install.py with bootstrap Python                      │
│  ↓                                                          │
│  install.py downloads target Python version                 │
│  ↓                                                          │
│  Installs to ~/.python-nonadmin                             │
│  ↓                                                          │
│  Configures pip + PATH                                      │
└─────────────────────────────────────────────────────────────┘

Platform-Specific Approaches

Platform	Bootstrap Python	Target Python
Windows	Python embeddable package	Python embeddable package
macOS	python-build-standalone	python-build-standalone
Linux	python-build-standalone	python-build-standalone

---

Installation Directory

Platform	Location
Windows	%USERPROFILE%\.python-nonadmin
macOS	$HOME/.python-nonadmin
Linux	$HOME/.python-nonadmin

---

Verifying Installation

python --version
pip --version
python -c "import sys; print(sys.executable)"
python examples/demo.py

---

Activating in Current Session

After installation, either restart your terminal or:

Windows (PowerShell)

. .\scripts\activate.ps1

macOS / Linux

source ./scripts/activate.sh

---

Creating Virtual 环境

python -m venv myproject-env

# Activate
# Windows: .\myproject-env\Scripts\Activate.ps1
# Unix: source myproject-env/bin/activate

pip install requests flask pandas

---

Troubleshooting

Windows

Execution policy error:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Corporate proxy:

$env:HTTP_PROXY = "http://proxy.company.com:8080"
$env:HTTPS_PROXY = "http://proxy.company.com:8080"
.\install.cmd

macOS

Gatekeeper warning:

xattr -dr com.apple.quarantine ~/.python-nonadmin

Linux

glibc version mismatch:

• Default builds require glibc 2.17+
• For very old systems, consider building from source

---

Platform-Specific Documentation

• Windows Guide
• macOS Guide
• Linux Guide

---

Use Cases

• 🏢 Corporate laptops – Work on locked-down enterprise machines
• 🎓 Academic labs – Develop on shared university computers
• 🔒 Sandboxed environments – CI/CD pipelines with limited permissions
• 💾 Portable development – Run Python from USB drives
• 🧪 Testing – Isolated Python versions for testing

---

Configuration

Edit config.json to change default Python version and download URLs.

Supported versions (tested):

• 3.12.8 (default)
• 3.12.7
• 3.11.9
• 3.11.8
• 3.10.14
• 3.10.13

---

Uninstallation

./install.sh --uninstall
# or on Windows:
install.cmd --uninstall

This removes the ~/.python-nonadmin directory. You may also want to clean up shell profile entries manually.

---

License

MIT License - See LICENSE for details.

---

Contributing

Contributions welcome!