নিজস্ব (লোকাল) AI চালু করার গাইড — কোনো সাবস্ক্রিপশন, লগইন বা API key ছাড়া
=====================================================================

এটা কী?
  সফটওয়্যারের সব AI কাজ (AI দিয়ে প্রশ্ন তৈরি, ছবি থেকে প্রশ্ন পড়া, নোটিশ/হোমওয়ার্ক খসড়া, AI ইনসাইটস)
  এখন আপনার নিজের সার্ভারে চালানো একটা ওপেন-সোর্স মডেলে চলতে পারে। Gemini/OpenAI-তে কিছু যায় না।
  সফটওয়্যারের অংশটা তৈরি। বাকি কাজ: যে কম্পিউটারে AI চালাবেন সেখানে Ollama ইনস্টল করা (নিচে)।

সবচেয়ে সহজ উপায় — এক ক্লিকে ইনস্টলার (শিক্ষকদের কিছু করতে হবে না)
  * অ্যাডমিন ▸ AI সেটিংস ▸ "এক ক্লিকে নিজস্ব AI ইনস্টল" কার্ড।
  * "শুধু এই কম্পিউটারের জন্য" বা "স্কুলের অন্য কম্পিউটারগুলোও ব্যবহার করবে" বেছে Windows (.bat) বা Linux (.sh) ইনস্টলার নামান।
  * AI যে কম্পিউটারে চলবে (একটাই কম্পিউটার), সেখানে ফাইলটা ডাবল-ক্লিক করে চালান। এটা নিজে Ollama ও মডেল নামিয়ে ইনস্টল করবে।
  * শেষে স্ক্রিনে যে URL ও মডেলের নাম দেখাবে, সেটা AI সেটিংসে বসান। ব্যস — সব শিক্ষক আগের মতো বাটন চেপেই AI ব্যবহার করবেন।
  * শিক্ষকদের নিজের পিসিতে কিছু ইনস্টল করার দরকার নেই (ওয়েবসাইট কারো পিসিতে নিজে ইনস্টল করতে পারে না; আর শিক্ষকের পিসির AI
    সার্ভারে চলা সফটওয়্যার ধরতেও পারে না — তাই একটা কেন্দ্রীয় AI কম্পিউটারই সহজ ও নির্ভরযোগ্য)।
  * Windows নিরাপত্তা সতর্কতা দিলে "More info > Run anyway" চাপুন। এন্টিভাইরাস .bat ফাইল আটকালে সাময়িক অনুমতি দিন।
  * নিচের ম্যানুয়াল ধাপগুলো শুধু ইনস্টলার কাজ না করলে লাগবে।

ধাপ ১ — AI চালানোর কম্পিউটার ঠিক করুন (সবচেয়ে গুরুত্বপূর্ণ)
  * সাধারণ cPanel শেয়ার্ড হোস্টিংয়ে AI মডেল চলে না। লাগবে নিজের কম্পিউটার/সার্ভার বা আলাদা VPS।
  * মোটামুটি হিসাব (ছোট মডেল gemma3:4b / বড় মডেল gemma3:12b):
      - gemma3:4b  : ৮ GB RAM হলে চলে (GPU ছাড়াও), প্রশ্ন বানাতে কয়েক সেকেন্ড থেকে আধ মিনিট।
      - gemma3:12b : ১৬ GB RAM বা ৮-১২ GB VRAM-এর GPU ভালো; বাংলা মান তুলনায় ভালো।
  * বাংলার মান Gemini-র চেয়ে কম হতে পারে। প্রতিটা প্রশ্ন শিক্ষক দেখে/এডিট করে সেভ করবেন (এই ধাপ আগেই আছে)।

ধাপ ২ — Ollama ইনস্টল ও মডেল নামান (ওই কম্পিউটারে, একবারই; মডেল নামাতে ইন্টারনেট লাগবে)
  1) https://ollama.com থেকে Ollama নামিয়ে ইনস্টল করুন (Windows / Linux / Mac)।
  2) টার্মিনাল (Windows-এ PowerShell) খুলে:
        ollama pull gemma3:4b
     (ভালো হার্ডওয়্যার থাকলে gemma3:12b)। gemma3 ছবিও বোঝে, তাই ছবি থেকে প্রশ্ন পড়াও এই এক মডেলে হবে।
  3) পরীক্ষা:   ollama run gemma3:4b "বাংলায় একটি MCQ প্রশ্ন লিখো"
  4) Ollama নিজে থেকে  http://127.0.0.1:11434  ঠিকানায় চলে।

ধাপ ৩ — সফটওয়্যারে সংযোগ
  অ্যাডমিন ▸ AI সেটিংস:
     * প্রোভাইডার: "নিজস্ব লোকাল AI — Ollama / llama.cpp"
     * URL:  http://127.0.0.1:11434/v1      (সফটওয়্যার ও Ollama একই কম্পিউটারে হলে)
     * মডেল: gemma3:4b                       (যেটা নামিয়েছেন হুবহু সেই নাম)
     * API Key: খালি রাখুন
     * "সংরক্ষণ করুন", তারপর "টেস্ট কল পাঠান" — মডেল না পেলে পেজেই বলে দেবে কী ইনস্টল করতে হবে।

যদি সফটওয়্যার হোস্টিংয়ে থাকে আর AI আলাদা কম্পিউটারে/VPS-এ চলে
  * AI সার্ভারে Ollama-কে বাইরে থেকে ধরার অনুমতি দিন:  OLLAMA_HOST=0.0.0.0:11434
  * ⚠ Ollama-তে নিজস্ব পাসওয়ার্ড নেই। পোর্ট ১১৪৩৪ সরাসরি ইন্টারনেটে খুলে দেবেন না — যে কেউ আপনার সার্ভার ব্যবহার করবে।
    Nginx দিয়ে টোকেন-সুরক্ষিত করুন (উদাহরণ):
        server {
          listen 443 ssl;  server_name ai.আপনার-ডোমেইন.com;   # SSL সার্টিফিকেটসহ
          location /v1/ {
            if ($http_authorization != "Bearer আপনার-লম্বা-গোপন-টোকেন") { return 401; }
            proxy_pass http://127.0.0.1:11434;
            proxy_set_header Host localhost:11434;
            proxy_read_timeout 300s;
          }
        }
  * সফটওয়্যারের AI সেটিংসে: URL = https://ai.আপনার-ডোমেইন.com/v1 ,  API Key = ওই গোপন টোকেন।

সীমাবদ্ধতা (জেনে রাখুন)
  * হাতের লেখা পড়া (ছবি থেকে প্রশ্ন) Gemini-র চেয়ে কম নির্ভুল হবে; পরিষ্কার ছাপা/স্পষ্ট লেখায় ভালো।
  * ছোট মডেল মাঝেমধ্যে ভুল ফরম্যাটে উত্তর দেয় — তখন "আবার চেষ্টা করুন" বার্তা আসে; বড় মডেলে এটা কমে।
  * মডেলের লাইসেন্স আলাদা (কোনোটা Apache 2.0, কোনোটার নিজস্ব শর্ত আছে, যেমন Gemma)। সফটওয়্যারের সাথে বিক্রি/বিতরণের
    আগে ব্যবহৃত মডেলের লাইসেন্স-শর্ত নিজে যাচাই করে নিন।
  * লোকাল AI চালু থাকলে শিক্ষকদের ব্যক্তিগত Gemini key আর ব্যবহার হয় না, আর বাইরের কোনো AI-তে স্বয়ংক্রিয়ভাবে
    ফিরে যাওয়াও হয় না (আপনি চাইলে প্রোভাইডার বদলে আগের মতো Gemini/OpenAI চালাতে পারবেন)।

সমস্যা হলে
  * "সংযোগ করা যায়নি" -> Ollama চালু আছে কি (ব্রাউজারে http://127.0.0.1:11434 খুললে "Ollama is running" দেখায়)? URL ঠিক আছে কি?
  * "মডেল ইনস্টল নেই" -> সার্ভারে  ollama pull মডেল-নাম  চালান।
  * অনেক দেরি/টাইমআউট -> ছোট মডেল (gemma3:4b) নিন, অথবা AI সেটিংসে অপেক্ষার সময় বাড়ান।
