envknit 0.1.0

Multi-environment package manager for Python with dependency isolation

EnvKnit

Multi-version Python package manager — isolate environments, lock dependencies, and run multiple package versions side by side.

---

Quick Start

envknit init                              # creates envknit.yaml
envknit add "requests>=2.28"
envknit add "numpy>=1.24,<2.0" --env ml
envknit lock                              # creates envknit.lock.yaml
envknit install                           # installs to ~/.envknit/packages/
envknit run -- python -m pytest

---

Installation

CLI — download the standalone binary from the Releases page:

# Linux
curl -L https://github.com/wgsim/EnvKnit/releases/latest/download/envknit-linux-amd64 -o envknit
chmod +x envknit && sudo mv envknit /usr/local/bin/

# macOS (Apple Silicon)
curl -L https://github.com/wgsim/EnvKnit/releases/latest/download/envknit-macos-arm64 -o envknit
chmod +x envknit && sudo mv envknit /usr/local/bin/

Library:

pip install envknit       # requires Python 3.10+

---

Documentation

Guides

Document	Description
Getting Started	Installation, first run, 20-minute tutorial
Concepts	How EnvKnit works: store, PYTHONPATH, import hook
CLI Scripts	Running pytest, black, mypy with envknit run
Python Version	python_version field, mise/pyenv integration
Node Version	node_version field, fnm/nvm/mise integration
Python API	use(), worker(), configure_from_lock() API reference
CI Integration	GitHub Actions integration
Environments	Managing multiple environments

Reference

Document	Description
CLI Reference	Complete CLI command reference
Config Schema	envknit.yaml and global config fields
Lock Schema	envknit.lock.yaml structure

---

Contributing

git clone https://github.com/wgsim/EnvKnit.git
cd EnvKnit
cargo test          # Rust CLI
pip install -e ".[dev]" && python -m pytest   # Python library

---

License

MIT