wovensnake 0.3.2

A high-performance Python package manager built with Rust.
Documentation

Crates.io Documentation CI Status License Ko-Fi

"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 .

🎮 How to Use

1. Start a New Pattern (init)

Prepares wovenpkg.json for your project.

woven init

2. Add a New Thread (add)

Adds a package from PyPI to your project and installs it immediately.

woven add requests

3. Knit Dependencies (install)

Reads your pattern, gathers materials, and weaves the environment.

woven install

4. Run in the Nest (run)

Execute any command within the context of your virtual environment.

woven run python main.py

5. Tidy Up (remove)

Gently removes a package and its unused threads.

woven remove flask

6. View the Tapestry (list)

Admire the packages currently woven into your project.

woven list

7. 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.