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-30T04:46:48Z

# Name Type Installs Users

Top 10 Packages

Updated: 2026-03-30T04:46:48Z

# 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.27.tar.gz (421.3 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.27-py3-none-any.whl (49.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ipman_cli-0.2.27.tar.gz
  • Upload date:
  • Size: 421.3 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.27.tar.gz
Algorithm Hash digest
SHA256 f863ac1601b07ca456c2840e271f652e3558fb2a1a6b3671d55934ab900f5a4c
MD5 6123d54ce4a78c24d18b7d2ad076a40f
BLAKE2b-256 d97bc04029dd5f03abba94624bcd832257351ff6c96edc0b4b46201172544de3

See more details on using hashes here.

Provenance

The following attestation bundles were made for ipman_cli-0.2.27.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.27-py3-none-any.whl.

File metadata

  • Download URL: ipman_cli-0.2.27-py3-none-any.whl
  • Upload date:
  • Size: 49.9 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.27-py3-none-any.whl
Algorithm Hash digest
SHA256 56fc02784c5b26e8130a46511e2a821aa38b58eaa469dcee2425a223ba1e5a60
MD5 0b1132af19511769c9971fc6e42ef89d
BLAKE2b-256 d08760c444bec55812dfdf7f52864197d2dd24b9440880016695e61b344a33fb

See more details on using hashes here.

Provenance

The following attestation bundles were made for ipman_cli-0.2.27-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