ప్రారంభించండి

Pain001 ఇన్‌స్టాల్: pip, Docker, మొదటి ధృవీకృత ఫైల్

Python 3.10–3.12, pip లేదా Docker, మరియు మూడు కమాండ్లలో ధృవీకృత చెల్లింపు ఫైల్.

Pain001 macOS, Linux, Windowsలపై Python 3.10, 3.11, 3.12లలో నడుస్తుంది (ప్రతి వెర్షన్ CIలో పరీక్షించబడింది). మీకు కావలసినది మాత్రమే ఇన్‌స్టాల్ చేయండి; ప్రతి ఐచ్ఛిక సామర్థ్యం ఒక ఎక్స్‌ట్రా, కాబట్టి బేస్ ఇన్‌స్టాల్ తేలికగా ఉంటుంది.


01. PyPI#

మీకు కావలసినది కమాండ్
కోర్ CLI & Python లైబ్రరీ pip install pain001
REST API మైక్రోసర్వీస్ (FastAPI + Uvicorn) pip install "pain001[api]"
Parquet ఇన్‌జెషన్ (PyArrow) pip install "pain001[parquet]"
PGP-ఎన్‌క్రిప్టెడ్ ఇన్‌పుట్ ఫైళ్లు (.gpg / .asc) pip install "pain001[gpg]"
API కోసం Redis-ఆధారిత అసింక్ జాబ్ క్యూ pip install "pain001[redis]"
OpenTelemetry ట్రేసింగ్ pip install "pain001[otel]"
అంతర్నిర్మిత కనిష్ఠ MCP / LSP సర్వర్లు pip install "pain001[mcp]" / "pain001[lsp]"

సహ ప్యాకేజీలు విడిగా ఇన్‌స్టాల్ అవుతాయి మరియు స్వతంత్రంగా వెర్షన్ చేయబడతాయి:

pip install pain001-loader-xlsx    # Excel ingestion (auto-discovered plugin)
pip install pain001-loader-mt101   # SWIFT MT101 parsing library
pip install pain001-mcp            # Full 22-tool MCP server for AI agents
pip install pain001-lsp            # Full six-feature editor language server

ఇన్‌స్టాల్‌ను ధృవీకరించి సందేశ కేటలాగ్‌ను అన్వేషించండి:

pain001 --version
pain001 versions          # list all 11 supported message definitions
pain001 init pain.001.001.09   # scaffold a starter CSV template

02. Docker#

బహుళ-నిర్మాణ ఇమేజ్‌లు (linux/amd64, linux/arm64) GitHub Container Registryలో ప్రచురించబడతాయి. కంటైనర్ ప్రత్యేక నాన్-రూట్ యూజర్‌గా నడుస్తుంది.

# Generate XML from a local CSV
docker run --rm -v "$PWD:/data" -w /data \
  ghcr.io/sebastienrousseau/pain001:latest \
  generate -t pain.001.001.09 -d payments.csv -o out/

# Launch the REST API
docker run --rm -p 8000:8000 \
  ghcr.io/sebastienrousseau/pain001:latest \
  serve --host 0.0.0.0 --port 8000

03. లాక్-డౌన్ వాతావరణాలు#

బ్యాంక్ మరియు ట్రెజరీ వాతావరణాలు తరచుగా డైనమిక్ ప్లగిన్ లోడింగ్‌ను నిషేధిస్తాయి. సరిగ్గా ఆ సందర్భానికే రెండు నియంత్రణలు ఉన్నాయి:

  • PAIN001_DISABLE_PLUGINS=1 అన్ని మూడవ-పక్ష ప్లగిన్ డిస్కవరీని నిలిపేస్తుంది; బండిల్ చేసిన లోడర్లు మాత్రమే నడుస్తాయి.
  • pain001 plugins list / pain001 plugins show <name> కనుగొన్న ప్రతి ప్లగిన్‌ను మొదటి వినియోగానికి ముందే ఆడిట్ చేయదగినదిగా చేస్తాయి.

అన్నీ స్థానికంగానే అమలవుతాయి. సూట్‌లోని ఏ ప్యాకేజీ ఇంటికి ఫోన్ చేయదు, SaaS APIని కాల్ చేయదు, చెల్లింపు డేటాను హోస్ట్ నుండి తరలించదు.


04. మూడు కమాండ్లలో మొదటి ఫైల్#

pip install pain001
pain001 init pain.001.001.09 -o work/
pain001 -t pain.001.001.09 -d work/template.csv -o work/ --dry-run

--dry-run అవుట్‌పుట్ రాయకుండా JSON Schema, XSD, మరియు (--schemeతో) SEPA లేదా క్రాస్-బోర్డర్ రూల్‌బుక్‌కు వ్యతిరేకంగా ధృవీకరిస్తుంది. నిష్క్రమణ కోడ్ 0 అంటే ఫైల్ ఆ తనిఖీలలో ఉత్తీర్ణమైందని అర్థం: స్కీమా, మరియు ఎంపిక చేసినప్పుడు scheme రూల్‌బుక్. మీ బ్యాంకు సొంత ప్రొఫైల్ మరియు ఛానెల్ నియమాలు వేరు, వాటికి ఇప్పటికీ బ్యాంకుతో పరీక్ష అవసరం. XML రాయడానికి --dry-runను తొలగించండి.

ప్రతి ఫ్లాగ్ మరియు ఎండ్‌పాయింట్ కోసం సాంకేతిక సూచికకు, లేదా కార్యాచరణ ప్రశ్నల కోసం క్విక్‌స్టార్ట్ FAQకు కొనసాగండి.