🧶 WovenSnake

"Dependencies, neatly woven." 🐍🧶

WovenSnake is a cozy, high-performance Python package manager built with Rust. It knits your dependencies together securely, keeping your environment warm and tidy.

---

🍵 Why WovenSnake?

Managing packages shouldn't be a tangle. WovenSnake keeps things organized:

• ⚡ Swift Knitting: Parallel resolution and installation that finishes before your tea is ready.
• 🔒 Secure Stitching: Deterministic wovenpkg.lock ensures every install is identical.
• 📦 Global Cache: Shared storage in ~/.wovensnake/cache to avoid downloading the same package twice.
• 🌍 Truly Cross-Platform: Native binaries for macOS (arm64 & x86_64), Linux, and Windows — no Rosetta 2 penalty on Apple Silicon.
• 🧶 Self-Mending: Automatically removes loose threads (unused packages) to keep your project clean.
• 🏠 Zero-Config Home: Creates virtual environments automatically, so your packages have a safe place to live.

---

💻 Platform Support

Operating System	Architecture	Status
macOS	Apple Silicon (arm64)	✅ Supported
macOS	Intel (x86_64)	✅ Supported
Linux	x86_64	✅ Supported
Linux	aarch64	✅ Supported
Windows	x86_64	✅ Supported

---

💿 Installation

🚀 Automatic (Recommended)

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/jackby03/wovensnake/main/scripts/install.sh | bash

The installer auto-detects your architecture (arm64 or x86_64), downloads the right binary, and optionally adds woven to your PATH. Pass --yes to skip all prompts.

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/jackby03/wovensnake/main/scripts/install.ps1 | iex

📦 Pre-built Binaries

Download the binary for your platform from the latest release:

Platform	Binary
macOS (Apple Silicon)	woven-macos-arm64
macOS (Intel)	woven-macos-amd64
Linux (x86_64)	woven-linux-amd64
Windows (x86_64)	woven-windows-amd64.exe

🦀 From Source (Rustaceans)

cargo install --path .

♻️ Updating

Re-run the installer — it will overwrite the existing binary:

curl -fsSL https://raw.githubusercontent.com/jackby03/wovensnake/main/scripts/install.sh | bash

🗑️ Uninstalling

macOS / Linux — run the uninstall script (works even if woven is broken or not in PATH):

curl -fsSL https://raw.githubusercontent.com/jackby03/wovensnake/main/scripts/uninstall.sh | bash

Or if woven is already working:

woven self-uninstall

Both options remove the binary, the global cache (~/.wovensnake), and clean the PATH entry from your shell rc files. Add --yes to skip the confirmation prompt.

---

🎮 How to Use

1. Start a New Pattern (init)

Prepares wovenpkg.json for your project.

woven init

2. Knit Dependencies (install)

Install all dependencies from wovenpkg.json, or add and install specific packages in one step:

woven install                    # install everything in wovenpkg.json
woven install requests           # add requests and install
woven install requests flask     # add multiple packages
woven install flask==3.0.0       # add a specific version

3. Run in the Nest (run)

Execute any command within the context of your virtual environment.

woven run python main.py

4. Tidy Up (remove)

Gently removes a package and its unused threads.

woven remove flask

5. View the Tapestry (list)

Admire the packages currently woven into your project.

woven list

6. Fresh Start (clean)

Clears the virtual environment and local packages. Use --all to clear the global cache too.

woven clean

---

🧸 Support the Nest

Building such a cozy tool takes care and patience. If WovenSnake brought you comfort, consider supporting:

---

🤝 Contributing to the Nest

We follow a Trunk-Based Development workflow with strict CI verification. Check out CONTRIBUTING.md to get started.

📜 Licenssse

This project is licensed under the MIT License. Ssssee LICENSE for details.