Skip to main content

Internal Info Replacement CLI

Project description

iir — Internal Info Replacement

iir (Internal Info Replacement) is a lightweight system for safely replacing internal identifiers (hosts, domains, service names, user names, etc.) before sharing logs, documents, or prompts with external parties or AI systems.

It is designed as a structural safety layer: a tool that helps humans safely sanitize (replace) internal identifiers before sharing information outside a trusted boundary.


Intended usage note

iir is designed to be used inside a local or private environment such as a developer machine, LAN, or internal network, as a preprocessing tool before sharing text with external services (including public or hosted LLMs).

iir itself is not intended to be exposed as a public service. How and where it is operated is the responsibility of the user.

Please note that the dictionary used by iir should be treated as your private internal data. Depending on how entries are curated, it can easily become sensitive or security-relevant information.

iir is a utility to assist safe replacement workflows. It does not claim to provide complete security guarantees.


About MCP integration

MCP support is planned as an optional execution mode for iir. It is primarily intended for on-premise or self-hosted LLM setups, where model outputs need to be sanitized before being exposed externally.

MCP integration does not change the core concept of iir. Replacement logic and safety assumptions remain the same, and MCP is not required for using iir effectively.


Installation

pip install iir-tool

Note: The PyPI package name is iir-tool, but the CLI command is iir.


Two Usage Modes (Important)

iir supports two complementary usage modes.

1. Local / Personal Mode (CLI-First)

Designed for individual users and local workflows.

Typical uses cases:

  • Preparing logs or text before sharing
  • Sanitizing prompts before sending to AI tools
  • Ad-hoc replacement in pipelines or scripts

Characteristics:

  • CLI-first design (stdin → stdout)
  • Simple installation (extra config not required)
  • Suitable for quick evaluation via quickstart

2. Shared / Boundary Mode (API / Web / MCP)

This mode is intended to be deployed inside a LAN or private environment and to act as a boundary before data is shared with external services. It is not designed or recommended to be operated as a publicly exposed service.

This mode is commonly used in shared environments, team usage, and organizational boundaries.

Examples:

  • HTTP based replacement service (for internal use)
  • Web based replacement form for manual inspection
  • MCP adapter as an optional LLM safety layer

Basic Usage (CLI, Recommended)

echo "connect to my.domain" | iir replace

Links


License

This project is licensed under the MIT License.

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

iir_tool-0.1.9.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

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

iir_tool-0.1.9-py3-none-any.whl (5.0 kB view details)

Uploaded Python 3

File details

Details for the file iir_tool-0.1.9.tar.gz.

File metadata

  • Download URL: iir_tool-0.1.9.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for iir_tool-0.1.9.tar.gz
Algorithm Hash digest
SHA256 565b30e1256232fb6925587ee1ac403c515075002432fde0b3aee35027bf9e74
MD5 607da5f74fc9f6c6c1895e983d47d455
BLAKE2b-256 7e0d1e81b3ce756a0d8764b503fc46c852fd887fb6437393944e42dd922a4387

See more details on using hashes here.

File details

Details for the file iir_tool-0.1.9-py3-none-any.whl.

File metadata

  • Download URL: iir_tool-0.1.9-py3-none-any.whl
  • Upload date:
  • Size: 5.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for iir_tool-0.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 1c4edf32a68ffc23bffc991c1e66ea616c7d399704c83c7441321d6163cffdb5
MD5 8c68edd628763aa3d0d116a9ebff116d
BLAKE2b-256 a2d94486fbc0c06b2c9efa1d14bb675ccd19f85b02722fe7ffbb96f3e0450df5

See more details on using hashes here.

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