Skip to main content

Intelligence Package Manager - Agent skill virtual environment manager

Project description

IpMan Banner

IpMan - Intelligence Package Manager

I can take on ten.

Agent skill virtual environment manager — like conda/uv, but for AI agent skills. With built-in defense against malicious skills.

Documentation | 中文文档 | 中文 README


36% of AI agent skills contain prompt injection. 824+ confirmed malicious skills exist in the wild. IpMan doesn't just manage skills — it protects you from them.

Why IpMan?

The AI agent skill ecosystem is the new software supply chain — and it's under attack. Skills run with full agent permissions, have no sandbox by default, and the barrier to publishing is just a Markdown file. IpMan provides:

  • Risk assessment before installation — every skill is scanned for red flags (credential theft, data exfiltration, obfuscated code, prompt injection)
  • Four security modes — from PERMISSIVE (install everything) to STRICT (only verified-safe skills)
  • Community-driven threat reporting — flag suspicious skills, report counts feed back into risk scoring
  • Publish-time gatekeeping — HIGH/EXTREME risk skills are blocked from IpHub at the door

Features

Security First

  • Risk Assessment Engine — Detects credential harvesting, obfuscated code (base64/eval/exec), unauthorized network calls, sudo escalation, access to sensitive paths (~/.ssh, ~/.aws), and prompt injection patterns. Risk levels: LOW / MEDIUM / HIGH / EXTREME
  • Security Modes — PERMISSIVE, DEFAULT, CAUTIOUS, STRICT. Control the risk tolerance for your environment
  • Smart Trust Model — IpHub skills carry pre-assessed risk labels. Local/URL installs trigger mandatory on-device assessment. Override with --vet or --no-vet
  • Security Logging — All blocked/warned installs are logged to ~/.ipman/security.log
  • Community Reportingipman hub report <name> to flag suspicious skills. Report counts are publicly visible

Package Management

  • Virtual Environments — Create isolated skill environments per project, user, or machine
  • IP Packages — Bundle skills into distributable .ip.yaml files
  • Dependency Resolution — Recursive dependencies with version constraints (>=, ^, ~)
  • Agent Agnostic — Works with Claude Code, OpenClaw, and more via adapter plugins

IpHub Registry

  • Search & Browse — Find skills by keyword, filter by agent
  • Publish — Submit skills/IP packages via automated GitHub PR workflow
  • Rankings — Top skills by install count
  • Mirror Support — Configure alternative hub URLs for regional access (CNB mirror available)

Installation

# Via PyPI
pip install ipman-cli

# Via uv
uv pip install ipman-cli

# Via curl (Linux / macOS)
curl -sSL https://raw.githubusercontent.com/twisker/ipman/main/install.sh | bash

Pre-built binaries for Windows/macOS/Linux are available on GitHub Releases.

Quick Start

# Create and activate a skill environment
ipman env create myenv
ipman env activate myenv

# Install a skill (auto-assessed for security risks)
ipman install web-scraper

# Install from a local IP package (triggers mandatory risk scan)
ipman install frontend-kit.ip.yaml

# Pack current environment
ipman pack --name my-kit --version 1.0.0

# Search and publish to IpHub
ipman hub search scraper
ipman hub publish my-skill --description "My awesome skill"

# Report a suspicious skill
ipman hub report sketchy-tool --reason "Sends data to unknown server"

For the full guide, see the Documentation.

Security Modes

Mode Behavior Use case
permissive Install everything, warn only on EXTREME Trusted internal environments
default Block EXTREME, warn on HIGH General use
cautious Block HIGH+EXTREME, warn on MEDIUM Production environments
strict Only LOW allowed; re-assess all sources locally High-security deployments

See the Security Guide for details.

IpHub Rankings

Top 10 Skills

Updated: 2026-03-31T04:37:17Z

# Name Type Installs Users

Top 10 Packages

Updated: 2026-03-31T04:37:17Z

# Name Type Installs Users

Star History

Star History Chart

License

Apache License 2.0 — see LICENSE for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ipman_cli-0.2.39.tar.gz (434.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ipman_cli-0.2.39-py3-none-any.whl (50.3 kB view details)

Uploaded Python 3

File details

Details for the file ipman_cli-0.2.39.tar.gz.

File metadata

  • Download URL: ipman_cli-0.2.39.tar.gz
  • Upload date:
  • Size: 434.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ipman_cli-0.2.39.tar.gz
Algorithm Hash digest
SHA256 4ed7f48af096051d5ab21f07442e4c19e6d65e63266f5991c23bdbc1a9e511ba
MD5 995c84b66cdd27e2f3a86e2487f5d301
BLAKE2b-256 b057a32e151808017ecd9abc1ede01819f599351b34d28cff76916b1a6e44510

See more details on using hashes here.

Provenance

The following attestation bundles were made for ipman_cli-0.2.39.tar.gz:

Publisher: publish.yml on twisker/ipman

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ipman_cli-0.2.39-py3-none-any.whl.

File metadata

  • Download URL: ipman_cli-0.2.39-py3-none-any.whl
  • Upload date:
  • Size: 50.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ipman_cli-0.2.39-py3-none-any.whl
Algorithm Hash digest
SHA256 6362b57d079950fa9c76f260275ab90b12ed2db84567152d77ae0a11e4bb2461
MD5 fbdb0d5b1e905076250f0ad840eb24e4
BLAKE2b-256 2bc3d4d9be60b1afd1d38a9302942fa3361ec18e55de58634b551858c3020d3e

See more details on using hashes here.

Provenance

The following attestation bundles were made for ipman_cli-0.2.39-py3-none-any.whl:

Publisher: publish.yml on twisker/ipman

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page