poks 0.1.0

A lightweight archive downloader for pre-build binary dependencies.

Poks

---

Source Code: https://github.com/cuinixam/poks

---

A lightweight, cross-platform archive downloader for pre-built binary dependencies. Inspired by Scoop, Poks provides a uniform way to install and manage developer tools using simple JSON manifests.

Features

• Cross-Platform: Works on Windows, Linux, and macOS
• No Admin Rights: Installs tools in user space
• Deterministic: Pin exact versions in manifests for reproducible builds
• Relocatable: The apps directory is self-contained and portable

Installation

Install via pipx(or your favorite package manager):

pipx install poks

Quick Start

Create a poks.json configuration file:

{
    "buckets": [
        {
            "name": "main",
            "url": "https://github.com/poks/main-bucket.git"
        }
    ],
    "apps": [
        {
            "name": "cmake",
            "version": "3.28.1",
            "bucket": "main"
        }
    ]
}

Install the defined tools:

poks install -c poks.json

CLI Commands

# Install tools from config file
poks install -c poks.json

# Install a specific tool
poks install zephyr-sdk@0.16.5-1 --bucket main

# Uninstall a specific version
poks uninstall zephyr-sdk@0.16.5-1

# Uninstall all versions of an app
poks uninstall zephyr-sdk

# Uninstall everything
poks uninstall --all

Documentation

For detailed specifications and manifest format, see docs/specs.md.

Development

This project uses pypeline for build automation.

# Run full pipeline (lint + tests)
pypeline run

# Run only linting
pypeline run --step PreCommit

# Run tests with specific Python version
pypeline run --step CreateVEnv --step PyTest --single --input python_version=3.13

For AI agents and contributors, see AGENTS.md for development guidelines.

Credits

This package was created with Copier and the browniebroke/pypackage-template project template.