Requirements
- Python 3.10 or higher
- pip package manager
Basic Installation
Install iso8583sim from PyPI:Optional Dependencies
LLM Providers
For AI-powered message explanation and generation:MCP Server
To use iso8583sim from Claude, Cursor or another MCP client:REST API
PIN Blocks and MACs
Performance Extensions
The compiled Cython extensions (about 2x faster parsing) are included in the wheels on PyPI for CPython 3.10 to 3.14 on:- Linux: x86_64 and aarch64 (glibc and musl)
- macOS: Intel and Apple Silicon
- Windows: x64
pip install --no-binary iso8583sim iso8583sim. To check which you have:
Development
For development and testing:Documentation
The docs are built with Mintlify from thedocs/ folder. To preview them locally (needs Node.js 20.17 or newer):
Development Installation
Clone and install in development mode:Verify Installation
Next Steps
- Quick Start Tutorial - Build your first message
- ISO 8583 Concepts - Learn the basics