Linux-এ DeepSeek Harness ডেস্কটপ সংস্করণ ইনস্টল, চালানো ও বিল্ড করা

প্রকল্প পরিচিতি

DeepSeek Harness Linux হলো অফিসিয়াল DeepSeek Harness-এর একটি ডাউনস্ট্রিম fork, যার লক্ষ্য Linux ব্যবহারকারীদের সরাসরি ডাউনলোড, ইনস্টল ও আপডেট করার উপযোগী ডেস্কটপ সংস্করণ সরবরাহ করা। এতে upstream ডেস্কটপের agent, skill, নেটওয়ার্ক সুবিধা, frontend, প্লাগইন ব্যবস্থা এবং যোগাযোগ প্রোটোকল বজায় রাখা হয়েছে; শুধু Linux প্যাকেজিং, পরীক্ষা ও বিতরণের জন্য সমর্থন যোগ করা হয়েছে।

দ্রষ্টব্য: এই প্রকল্পটি DeepSeek-এর অফিসিয়াল রিলিজ নয় এবং এতে agent kernel পরিবর্তন করা হয়নি। upstream এখনো developer preview পর্যায়ে রয়েছে, তাই ঘন ঘন আপডেট বা breaking change দেখা দিতে পারে।

প্রকল্পটি x64 এবং arm64 উভয়ই সমর্থন করে। প্রথমটি সাধারণ AMD ও Intel কম্পিউটারের জন্য, আর দ্বিতীয়টি Raspberry Pi 5, ARM সার্ভার এবং Apple Silicon ডিভাইসে চলমান Linux-এর জন্য উপযোগী।

প্রধান বৈশিষ্ট্য

• তিনটি রিলিজ ফরম্যাট: AppImage, .deb এবং .tar.gz সরবরাহ করা হয়।
• দুই আর্কিটেকচার সমর্থন: একই সঙ্গে x64 ও arm64 সংস্করণ বিল্ড করা হয়।
• AppImage স্বয়ংক্রিয় আপডেট: electron-updater এবং nightly-linux.yml আপডেট চ্যানেলের মাধ্যমে কাজ করে।
• নেটিভ CI: সংশ্লিষ্ট আর্কিটেকচারের জন্য যথাক্রমে ubuntu-24.04 এবং ubuntu-24.04-arm runner ব্যবহার করা হয়।
• upstream অনুসরণ: agent kernel এবং প্রধান ডেস্কটপ সুবিধাগুলো অফিসিয়াল প্রকল্পের সঙ্গে সামঞ্জস্যপূর্ণ রাখা হয়েছে।
• MIT লাইসেন্স: upstream কোড এবং নতুন Linux প্যাকেজিং স্তর MIT লাইসেন্সের অধীনে বিতরণ করা হয়।

সঠিক ইনস্টলেশন প্যাকেজ বেছে নিন

AppImage: অধিকাংশ ব্যবহারকারীর প্রথম পছন্দ

AppImage একটি একক-ফাইল প্রোগ্রাম; প্রচলিত ইনস্টলেশনের প্রয়োজন হয় না এবং প্রকল্পের দেওয়া স্বয়ংক্রিয় আপডেট চ্যানেল সমর্থন করে। দ্রুত ব্যবহার শুরু করতে বা সিস্টেমের প্যাকেজ ব্যবস্থাপনা পরিবর্তন এড়াতে ইচ্ছুক ব্যবহারকারীদের জন্য এটি উপযোগী।

DEB: Debian ও Ubuntu-এর জন্য উপযোগী

.deb ফাইল Debian সিস্টেমের প্যাকেজ ব্যবস্থাপনা সরঞ্জাম দিয়ে ইনস্টল করা যায় এবং অ্যাপ্লিকেশন মেনু বা টার্মিনাল থেকে চালু করা যায়। যারা অ্যাপ্লিকেশনটি সিস্টেমের ডেস্কটপ পরিবেশের সঙ্গে একীভূত করতে চান, তাদের জন্য এটি উপযোগী।

tar.gz: পোর্টেবলভাবে চালানো

.tar.gz এক্সট্র্যাক্ট করার পর সরাসরি চালানো যায়, ইনস্টলেশনের প্রয়োজন হয় না। পোর্টেবল ডিরেক্টরি, পরীক্ষামূলক পরিবেশ বা সিস্টেম সফটওয়্যার প্যাকেজ ইনস্টল করা সম্ভব নয় এমন পরিস্থিতিতে এটি উপযোগী।

ইনস্টলেশনের আগে আর্কিটেকচার নিশ্চিত করুন

প্রথমে টার্মিনালে বর্তমান সিস্টেমের আর্কিটেকচার দেখুন:

uname -m

• আউটপুট x86_64 হলে, ফাইলের নামের মধ্যে linux-x64 থাকা সংস্করণ ডাউনলোড করুন।
• আউটপুট aarch64 বা arm64 হলে, ফাইলের নামের মধ্যে linux-arm64 থাকা সংস্করণ ডাউনলোড করুন।

প্যাকেজগুলো প্রকল্পের Releases পৃষ্ঠা থেকে পাওয়া যাবে। কমিউনিটি বিল্ড শুধুমাত্র এই repository-এর Release থেকে ডাউনলোড করুন।

পদ্ধতি ১: AppImage চালানো

README-তে AppImage-কে প্রস্তাবিত ইনস্টলেশন পদ্ধতি হিসেবে উল্লেখ করা হয়েছে। এটি FUSE 2-এর ওপর নির্ভর করে, তাই বিতরণ অনুযায়ী প্রয়োজনীয় runtime আগে ইনস্টল করুন।

Debian বা Ubuntu ব্যবহারকারীরা চালান:

sudo apt install libfuse2

Fedora বা RHEL-ভিত্তিক ব্যবহারকারীরা চালান:

sudo dnf install fuse2

আর্কিটেকচারের সঙ্গে মিলে এমন AppImage ডাউনলোড করে ফাইলটিকে executable করুন। নিচে x64 ফাইলের উদাহরণ দেওয়া হলো:

chmod +x deepseek-harness-*-linux-x64.AppImage
./deepseek-harness-*-linux-x64.AppImage

arm64 ব্যবহারকারীদের কমান্ডের linux-x64-এর বদলে linux-arm64 লিখতে হবে, অথবা ডাউনলোড করা প্রকৃত ফাইলের নাম ব্যবহার করতে হবে।

পদ্ধতি ২: DEB প্যাকেজ ইনস্টল করা

Debian, Ubuntu এবং তাদের ডেরিভেটিভ বিতরণে ডাউনলোড করা প্যাকেজটি dpkg দিয়ে ইনস্টল করা যায়:

sudo dpkg -i deepseek-harness-*-linux-x64.deb

ইনস্টলেশন শেষ হলে ডেস্কটপ অ্যাপ্লিকেশন মেনু থেকে বা টার্মিনালে নিচের কমান্ড চালিয়ে শুরু করা যায়:

deepseek-harness

arm64 সিস্টেমে ফাইলের নামের মধ্যে linux-arm64 থাকা DEB প্যাকেজ ইনস্টল করুন।

পদ্ধতি ৩: পোর্টেবল আর্কাইভ চালানো

সিস্টেম প্যাকেজ ইনস্টল করতে না চাইলে .tar.gz এক্সট্র্যাক্ট করে ডিরেক্টরির startup entry সরাসরি চালাতে পারেন:

tar -xzf deepseek-harness-*-linux-x64.tar.gz
cd deepseek-harness-*-linux-x64
./deepseek-harness

arm64 ব্যবহারকারীদেরও সংশ্লিষ্ট আর্কিটেকচারের ফাইল বেছে নিয়ে এক্সট্র্যাক্ট করতে হবে।

মৌলিক ব্যবহার

প্রোগ্রাম চালু হলে upstream থেকে পাওয়া ডেস্কটপ সুবিধাগুলো ব্যবহার করা যাবে, যার মধ্যে agent, skill, নেটওয়ার্ক সুবিধা এবং ডেস্কটপ frontend রয়েছে। এই Linux fork agent kernel, প্লাগইন ব্যবস্থা বা যোগাযোগ প্রোটোকল পরিবর্তন করেনি, তাই সংশ্লিষ্ট আচরণ অফিসিয়াল DeepSeek Harness-এর বাস্তবায়নের সঙ্গে সামঞ্জস্যপূর্ণ থাকবে।

AppImage ব্যবহার করলে ডাউনলোড করা একক ফাইলটি রেখে বারবার সরাসরি চালানো যায়; DEB প্যাকেজ ইনস্টল করা থাকলে deepseek-harness কমান্ড বা অ্যাপ্লিকেশন মেনু থেকে চালু করা যায়; পোর্টেবল সংস্করণটি এক্সট্র্যাক্ট করা ডিরেক্টরি থেকে ./deepseek-harness চালিয়ে শুরু করতে হবে।

রিমোট ডেস্কটপ বা display ছাড়া পরিবেশে চালানো

প্রোগ্রামটি একটি ডেস্কটপ অ্যাপ্লিকেশন। VNC-সহ রিমোট সার্ভারে ব্যবহার করলে DISPLAY সঠিকভাবে সেট করা আছে কি না নিশ্চিত করুন। উদাহরণস্বরূপ, xfce4 ও TigerVNC পরিবেশে display নম্বর :1 হতে পারে:

export DISPLAY=:1
./deepseek-harness

display পরিবেশ উপলভ্য থাকলে ডেস্কটপ প্রোগ্রামটি স্বয়ংক্রিয়ভাবে চালু হবে। প্রকৃত display নম্বর বর্তমান VNC বা গ্রাফিক্যাল সেশন কনফিগারেশনের ওপর নির্ভর করবে।

সোর্স থেকে বিল্ড করা

নির্ভরতা প্রস্তুত করুন

সোর্স থেকে বিল্ড করতে Node.js 24 বা তার পরের সংস্করণ, pnpm এবং বিল্ড host-এ libfuse2 প্রয়োজন। libfuse2 AppImage প্যাকেজ তৈরিতে ব্যবহৃত হয়।

ক্লোন করে নির্ভরতা ইনস্টল করুন

git clone https://github.com/Zhou-Yujing114514/deepseek-harness-linux.git
cd deepseek-harness-linux
pnpm install

Linux পরিবেশের ফাইল প্রস্তুত করুন

প্রকল্পের দেওয়া নমুনা ফাইলটি কপি করে প্রয়োজন অনুযায়ী release সেটিংস পূরণ করুন:

cp apps/desktop/.env.linux.example apps/desktop/.env.linux

লক্ষ্য আর্কিটেকচার বিল্ড করুন

x64 ইনস্টলেশন প্যাকেজ বিল্ড করতে:

pnpm --dir apps/desktop run package:linux:x64

arm64 ইনস্টলেশন প্যাকেজ বিল্ড করতে:

pnpm --dir apps/desktop run package:linux:arm64

প্রতিটি আর্কিটেকচারের জন্য AppImage, DEB এবং tar.gz এই তিনটি ফরম্যাট তৈরি হবে। প্রকল্পের Desktop (Linux) workflow-ও নেটিভ runner-এ প্রয়োজন অনুযায়ী বিল্ড করে; উৎপন্ন ফাইল GitHub Actions Artifacts অথবা স্বয়ংক্রিয়ভাবে তৈরি Release থেকে পাওয়া যাবে।

স্বয়ংক্রিয় আপডেট ও নিরাপত্তা যাচাই

AppImage electron-updater ব্যবহার করে AppImage update channel-এর মাধ্যমে আপডেট হয়। আপডেট descriptor হলো nightly-linux.yml, এবং স্থানান্তরের সময় HTTPS ব্যবহার করা হয়।

গুরুত্বপূর্ণ: বর্তমান Linux বিল্ডে code signing নেই। স্বয়ংক্রিয় আপডেট শুধু HTTPS স্থানান্তর এবং feed metadata যাচাইয়ের ওপর নির্ভর করে; code signing verification নেই। তাই উচ্চ-আস্থার সরাসরি ব্যবহারের জন্য এটি উপযুক্ত নয়।

ডাউনলোড বা আপডেটের পর ফাইলের SHA256 Release পৃষ্ঠায় দেওয়া checksum-এর সঙ্গে তুলনা করুন। নিচের কমান্ড দিয়ে digest গণনা করা যায়:

sha256sum deepseek-harness-*-linux-x64.AppImage

নিশ্চিত করুন যে আউটপুট Release-এ প্রকাশিত মানের সঙ্গে সম্পূর্ণ মিলে গেছে। DEB, tar.gz এবং arm64 ফাইলও একইভাবে যাচাই করা যায়।

পরিচিত সীমাবদ্ধতা

1. বিল্ড স্বাক্ষরবিহীন: Linux binary-তে code signing বা system-level notarization নেই।
2. Office ডকুমেন্ট রূপান্তর বর্তমানে অপ্রাপ্য: DOCX, XLSX ও PPTX থেকে PDF রূপান্তর LibreOffice Kit-এর Linux native binding-এর ওপর নির্ভর করে, যা বর্তমান সংস্করণের ইনস্টলেশন প্যাকেজের সঙ্গে বিতরণ করা হয়নি।
3. upstream এখনো preview পর্যায়ে: অফিসিয়াল প্রকল্পটি developer preview পর্যায়ে রয়েছে, তাই ঘন ঘন বা breaking change ঘটতে পারে।
4. অ্যাপ স্টোর সংস্করণ নেই: প্রকল্পটি অ্যাপ স্টোরের প্রকাশনা প্রক্রিয়ার মধ্য দিয়ে যায় না।

Office রূপান্তরের সীমাবদ্ধতা README-তে স্পষ্টভাবে উল্লেখ করা অন্যান্য ডেস্কটপ সুবিধা, যেমন agent, skill, নেটওয়ার্ক সুবিধা এবং frontend-কে প্রভাবিত করে না।

উন্নত পরামর্শ

• সঠিক আর্কিটেকচারকে অগ্রাধিকার দিন: x64 সিস্টেমে arm64 প্যাকেজ বা তার বিপরীতটি ডাউনলোড করবেন না।
• আপডেট সুবিধা প্রয়োজন হলে AppImage বেছে নিন: DEB এবং tar.gz-এর README-তে AppImage update channel ব্যবহারের কথা বলা নেই।
• যাচাইয়ের ধাপ বজায় রাখুন: প্রথম ডাউনলোড বা আপডেট, উভয় ক্ষেত্রেই Release-এর SHA256 যাচাই করুন।
• upstream পরিবর্তন অনুসরণ করুন: এই fork upstream commit-গুলোতে নিয়মিত rebase করবে, তাই আপগ্রেডের আগে Release-এর বিবরণ দেখুন।
• ডেভেলপারদের নেটিভ CI ব্যবহার করা উচিত: দুই আর্কিটেকচার একসঙ্গে যাচাই করতে হলে cross-build-এর ফলাফল native build-এর সমান ধরে না নিয়ে প্রকল্পের বিদ্যমান Desktop (Linux) workflow ব্যবহার করুন।

চালানোর আগে upstream-এর SAFETY.md পড়ুন। অফিসিয়াল upstream প্রকল্পটি deepseek-ai/deepseek-harness-এ রয়েছে।

সারসংক্ষেপ

DeepSeek Harness Linux অফিসিয়াল ডেস্কটপ সংস্করণে x64 ও arm64 Linux বিতরণ সুবিধা যোগ করে। সাধারণ ব্যবহারকারীরা স্বয়ংক্রিয় আপডেট সমর্থনকারী AppImage বেছে নিতে পারেন; Debian বা Ubuntu ব্যবহারকারীরা DEB ইনস্টল করতে পারেন; আর পোর্টেবলভাবে চালাতে চাইলে tar.gz বেছে নেওয়া যায়। বর্তমান বিল্ডে স্বাক্ষর না থাকায় ডাউনলোড, আপডেট ও স্থাপনের সময় অবশ্যই SHA256 যাচাই করুন এবং developer preview পর্যায়ের সামঞ্জস্য পরিবর্তনের দিকে নজর রাখুন।