🐍 PyInstaller संपूर्ण गाइड: Python स्क्रिप्ट्स को Executable में बदलें

अंतिम अपडेट: मार्च 2026 | द्वारा: @trixsearch

जानें कैसे अपनी Python स्क्रिप्ट्स को स्टैंडअलोन executables में बदलें Windows, Linux और macOS के लिए। Target मशीन पर Python इंस्टाल करने की जरूरत नहीं!

📌 त्वरित सारांश: PyInstaller Python स्क्रिप्ट्स को सिंगल executables में पैकेज करता है। बिना सोर्स कोड दिखाए टूल्स शेयर करने के लिए परफेक्ट।

📦 इंस्टालेशन

pip install pyinstaller

🚀 बेसिक उपयोग

सिंगल-फाइल Executable:

pyinstaller --onefile your_script.py

⚡ PyInstaller के सभी Flags की जानकारी

📁 आउटपुट विकल्प

Flag	विवरण	उदाहरण
`--onefile`	सिंगल executable फाइल बनाएं	`--onefile script.py`
`--onedir`	फोल्डर में exe + डिपेंडेंसी (डिफ़ॉल्ट)	`--onedir script.py`
`--name`	executable का कस्टम नाम	`--name="मेरा_ऐप"`
`--distpath`	आउटपुट डायरेक्टरी	`--distpath ./आउटपुट`

🎨 आइकन और विजुअल्स

Flag	विवरण	उदाहरण
`--icon`	कस्टम आइकन जोड़ें (.ico)	`--icon=ऐप.ico`
`--windowed`	कंसोल छुपाएं (GUI ऐप्स के लिए)	`--windowed gui.py`
`--console`	कंसोल दिखाएं (डिफ़ॉल्ट)	`--console script.py`
`--version-file`	वर्शन जानकारी जोड़ें	`--version-file=ver.txt`

🔧 एडवांस्ड विकल्प

Flag	विवरण	उदाहरण
`--uac-admin`	एडमिन राइट्स मांगें (Windows)	`--uac-admin script.py`
`--hidden-import`	छूटे हुए मॉड्यूल शामिल करें	`--hidden-import=requests`
`--collect-all`	पैकेज का सारा डेटा इकट्ठा करें	`--collect-all pandas`
`--add-data`	अतिरिक्त फाइलें जोड़ें	`--add-data "डेटा.txt;."` (Windows)
`--add-data`	अतिरिक्त फाइलें जोड़ें	`--add-data "डेटा.txt:."` (Linux/Mac)
`--clean`	बिल्ड से पहले कैश साफ करें	`--clean script.py`
`--noconfirm`	बिना पूछे आउटपुट बदलें	`--noconfirm script.py`
`--key`	बाइटकोड एन्क्रिप्ट करें	`--key=आपकी_चाबी123`
`--upx-dir`	UPX से कंप्रेस करें	`--upx-dir ./upx`
`--exclude-module`	खास मॉड्यूल हटाएं	`--exclude-module tkinter`

💡 आम उपयोग के तरीके

बेसिक CLI टूल:

pyinstaller --onefile --name="मेरा_टूल" script.py

GUI एप्लिकेशन (बिना कंसोल):

pyinstaller --onefile --windowed --icon=ऐप.ico --name="मेरा_ऐप" gui.py

प्रोफेशनल Windows ऐप एडमिन राइट्स के साथ:

pyinstaller --onefile --windowed --uac-admin --icon=ऐप.ico --version-file=version.txt --name="प्रो_ऐप" app.py

बाहरी डेटा फाइलों वाली स्क्रिप्ट:

pyinstaller --onefile --add-data "config.json;." --add-data "images;images" --name="डेटा_ऐप" script.py

कई डिपेंडेंसी वाला कॉम्प्लेक्स ऐप:

pyinstaller --onefile --hidden-import=pandas --collect-all numpy --collect-all requests --name="कॉम्प्लेक्स_ऐप" script.py

📝 वर्शन फाइल टेम्पलेट (version.txt)

# UTF-8
VSVersionInfo(
  ffi=FixedFileInfo(
    filevers=(1,0,0,0),
    prodvers=(1,0,0,0),
    mask=0x3f,
    flags=0x0,
    OS=0x40004,
    fileType=0x1,
    subtype=0x0,
    date=(0,0)
    ),
  kids=[
    StringFileInfo(
      [
      StringTable(
        u'040904B0',
        [StringStruct(u'CompanyName', u'आपकी कंपनी'),
        StringStruct(u'FileDescription', u'एप्लिकेशन विवरण'),
        StringStruct(u'FileVersion', u'1.0.0'),
        StringStruct(u'InternalName', u'ऐप_नाम'),
        StringStruct(u'LegalCopyright', u'© 2024'),
        StringStruct(u'OriginalFilename', u'ऐप.exe'),
        StringStruct(u'ProductName', u'प्रोडक्ट नाम'),
        StringStruct(u'ProductVersion', u'1.0.0')])
      ]),
    VarFileInfo([VarStruct(u'Translation', [1033, 1200])])
  ]
)

🖼️ ICO फाइलें बनाना

ImageMagick से PNG को ICO में बदलें:

convert image.png -define icon:auto-resize=256,128,64,48,32,16 icon.ico

🎯 प्लेटफॉर्म-विशेष बिल्ड

Windows (.exe):

# Windows पर बनाएं
pyinstaller --onefile script.py  # script.exe बनेगा

Linux (बाइनरी):

# Linux पर बनाएं
pyinstaller --onefile script.py  # script (बिना एक्सटेंशन) बनेगा
chmod +x dist/script
./dist/script

macOS (.app):

# macOS पर बनाएं
pyinstaller --onefile --windowed script.py  # .app बंडल बनेगा

⚠️ महत्वपूर्ण नोट्स

क्रॉस-प्लेटफॉर्म: उसी OS पर बनाएं जिसके लिए बना रहे हैं। Windows exe सिर्फ Windows पर चलेगा।
फाइल साइज: One-file exe बड़े होते हैं (5-50MB) क्योंकि इनमें Python + डिपेंडेंसी होती है।
एंटीवायरस: कुछ AV सॉफ्टवेयर Python exe को फ्लैग कर सकते हैं। कोड साइनिंग का उपयोग करें।
सोर्स प्रोटेक्शन: PyInstaller कोड को कंपाइल करता है लेकिन पूरी तरह obfuscate नहीं करता। संवेदनशील कोड के लिए अतिरिक्त obfuscation का उपयोग करें।
टेम्प फाइल्स: One-file exe चलने पर टेम्प फोल्डर में एक्सट्रैक्ट होते हैं (Rufus की तरह)।

🔍 समस्या समाधान

❌ "Module not found" एरर:

pyinstaller --hidden-import=missing_module script.py

❌ Exe बहुत बड़ा है:

# UPX कंप्रेशन का उपयोग करें pyinstaller --upx-dir=/path/to/upx --onefile script.py

❌ आइकन नहीं दिख रहा:

.ico फाइल का एब्सोल्यूट पाथ उपयोग करें
Windows आइकन कैश साफ करें
.ico फॉर्मेट सुनिश्चित करें (PNG को रीनेम न करें)

📊 त्वरित संदर्भ कार्ड

📦 बेसिक पैकेज
--onefile script.py

🎨 आइकन के साथ
--icon=ऐप.ico script.py

🪟 GUI ऐप
--windowed gui.py

👑 एडमिन राइट्स
--uac-admin script.py

💻 संपूर्ण बिल्ड स्क्रिप्ट उदाहरण

build.bat बनाएं (Windows के लिए):

@echo off
echo एप्लिकेशन बनाया जा रहा है...
pyinstaller --onefile ^
--name="मेरा_ऐप" ^
--icon=ऐप.ico ^
--console ^
--clean ^
--noconfirm ^
--hidden-import=requests ^
--collect-all requests ^
--add-data "config.json;." ^
main.py
echo बिल्ड पूरा हुआ! dist फोल्डर चेक करें
pause

🎉 निष्कर्ष

PyInstaller गैर-तकनीकी उपयोगकर्ताओं के साथ Python एप्लिकेशन शेयर करने का सबसे आसान तरीका है। ऊपर दिए गए flags के साथ, आप किसी भी प्लेटफॉर्म के लिए प्रोफेशनल, पोर्टेबल executables बना सकते हैं।

📱 यह गाइड उपयोगी लगी?

इसे अन्य Python डेवलपर्स के साथ शेयर करें! अधिक ट्यूटोरियल के लिए, मेरा GitHub देखें: @trixsearch

यह ब्लॉग खोजें

tackmac docs