প্রকল্প সম্পর্কে

ফার্মিক্স হলো একটি ব্যক্তিগত, সেলফ-হোস্টেড এআই এজেন্ট প্ল্যাটফর্ম যা এলিক্সির/ওটিপি-তে লেখা। এটি আপনার নিজের মেশিনে একটি ব্যাকগ্রাউন্ড ডেমন হিসেবে চলে এবং আপনার ইতিমধ্যে ব্যবহৃত চ্যাট অ্যাপের মাধ্যমে আপনার কাছে পৌঁছায়। আপনি নিজের মডেল প্রোভাইডার কী নিয়ে আসেন—কোনো ফার্মিক্স ক্লাউড নেই, এবং আপনার কনফিগ, হিস্ট্রি ও লগ `~/.fermix`-এর অধীনে থাকে। **মূল বৈশিষ্ট্য:** - **এক রানটাইম:** সবকিছু একটি বিম ভিএম-এ একটি একক এলিক্সির/ওটিপি অ্যাপ্লিকেশন—কোনো এইচটিটিপি ব্রিজ, এক্সটার্নাল ওয়ার্কার পুল বা মেসেজ ব্রোকার নেই। পার্সিস্টেন্ট এজেন্ট, কনকারেন্ট কথোপকথন এবং ইন-প্রসেস সাব-এজেন্ট সবই সেই ডিজাইন থেকে আসে। - **যেকোনো জায়গায় আপনার কাছে পৌঁছায়:** টেলিগ্রাম, হোয়াটসঅ্যাপ, স্ল্যাক, ডিসকর্ড, সিগন্যাল এবং একটি লোকাল সিএলআই সবই একই এজেন্ট লুপে শেষ হয়। একটি ফার্স্ট-পার্টি আইফোন কম্প্যানিয়ন (মোবাইল চ্যানেল) হলো ভিত্তি, যা অ্যাপ রিলিজ না হওয়া পর্যন্ত একটি কনফিগ ফ্ল্যাগের পিছনে সুপ্ত থাকে। - **নিজের মডেল আনুন:** সাতটি প্রোভাইডার—ওপেনএআই, ওপেনএআই কোডেক্স, অ্যানথ্রোপিক, স্পেসএক্সএআই, ওপেনরাউটার, মিস্ট্রাল এবং একটি কী-লেস লোকাল ওলামা—একটি প্রাইমারি হিসেবে নির্বাচিত হয় স্বয়ংক্রিয় ফলব্যাক চেইনসহ। সাব-এজেন্ট এবং শিডিউলড জব তাদের নিজস্ব সস্তা মডেলে পিন করা যায়। - **সর্বদা চালু:** শিডিউলড জব ডাইজেস্ট, ওয়াচার, রিমাইন্ডার এবং চেক চালায়—প্রতিটি আইসোলেটেড, বাউন্ডেড, টেকসইভাবে সংরক্ষিত এবং আপনার চ্যানেলের মাধ্যমে ডেলিভার করা হয়। কাজ রিবুটেও টিকে থাকে। - **স্বয়ংসম্পূর্ণ:** প্রতি প্ল্যাটফর্মে একটি সেলফ-এক্সট্র্যাক্টিং বাইনারি হিসেবে আসে এবং প্রথম রানে একটি ওএস সার্ভিস ইউনিট ইনস্টল করে। **কুইক স্টার্ট:** ```bash brew install tezra-io/tap/fermix fermix setup ``` `fermix setup` ব্যাকগ্রাউন্ড সার্ভিস ইনস্টল ও শুরু করে, তারপর সেটআপ ইউআরএল প্রিন্ট করে এবং কনফিগারেশন শেষ করতে আপনার ব্রাউজারে `http://127.0.0.1:4030/setup` খোলে। হেডলেস হোস্টে এটি পরিবর্তে একটি টার্মিনাল উইজার্ড চালায় (`--cli` এটি বাধ্য করে); `--no-service` সার্ভিস ইনস্টল না করে কনফিগার করে, এবং `--no-browser` খোলার বদলে ইউআরএল প্রিন্ট করে। **ইনস্টলেশন:** - হোমব্রু (ম্যাকওএস, লিনাক্স): `brew install tezra-io/tap/fermix` (প্লাগইন ভেরিফিকেশনের জন্য `cosign` প্রয়োজন) - সোর্স থেকে বিল্ড: এলিক্সির ≥ ১.১, এরলাং/ওটিপি ২৮ এবং জিগ ০.১৫.২ প্রয়োজন। ক্লোন করুন, `mix deps.get`, অ্যাসেট কম্পাইল করুন, বারিটো দিয়ে প্যাকেজ করুন, বাইনারি ইনস্টল করুন, তারপর `fermix setup`। **কনফিগারেশন:** `fermix setup` হলো প্রথম-রান কনফিগারেশনের একক এন্ট্রি পয়েন্ট। এটি `~/.fermix/config.toml`-এ একটি টাইপড স্ন্যাপশট লেখে এবং ওয়ার্কস্পেস রুট তৈরি করে (`skills`, `journals`, `realtime`, `traces`, `logs`, `auth.json`)। প্রোভাইডার অথ মোড (এপিআই কী বনাম ওঅথ), চ্যানেল সেটআপ এবং শিডিউলিং রিডমিতে আলোচনা করা হয়েছে। রানটাইম প্রিসিডেন্স: কম্পাইল-টাইম ডিফল্ট → পার্সিস্টেড সেটআপ স্টেট → এনভায়রনমেন্ট ভেরিয়েবল ওভাররাইড। শিডিউলড জব ডেলিভারি একটি স্পষ্ট প্রতি-জব টার্গেট বা `config.toml`-এ একটি ক্রন-নির্দিষ্ট ডিফল্ট চ্যানেল টার্গেট লক্ষ্য করতে পারে। ভয়েস নোটের ট্রান্সক্রিপশন প্লাগেবল (ওপেনএআই, স্পেসএক্সএআই, ডিপগ্রাম)। **এনভায়রনমেন্ট ভেরিয়েবল:** আপনি যদি `fermix setup` ব্যবহার করেন (যা আপনার ওএস কীচেইনে সিক্রেট সংরক্ষণ করে) তাহলে ক্রেডেনশিয়াল ভেরিয়েবল ঐচ্ছিক। হেডলেস/কন্টেইনার ডিপ্লয়মেন্টের জন্য, `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `XAI_API_KEY`, `OPENROUTER_API_KEY`, `MISTRAL_API_KEY`, প্লাস চ্যানেল টোকেন (হোয়াটসঅ্যাপ, ডিসকর্ড, স্ল্যাক, সিগন্যাল) এবং `FERMIX_HOME`, `FERMIX_TRACE_DIR`, `FERMIX_LOG_FILE`, `FERMIX_HTTP_BIND` এবং রিয়েলটাইম ভয়েস সেটিংসের মতো অপারেশনাল নব সেট করুন। **ব্যবহার:** - ডেমন কন্ট্রোল: `fermix service install`, `start`, `status`, `ask`, `logs`, `stop`, `restart`, `service uninstall` - লোকাল ভয়েস কম্প্যানিয়ন (ফার্মিক্সপেট): ঐচ্ছিক নেটিভ ম্যাকওএস অ্যাপ যা একটি ইউনিক্স সকেটের মাধ্যমে ডেমনের সাথে কথা বলে; সেটআপ পেজের মাধ্যমে সক্রিয় করুন, `fermix voice status` দিয়ে চেক করুন - চ্যানেল: টেলিগ্রাম (লং-পোল), হোয়াটসঅ্যাপ (ওয়েবহুক), স্ল্যাক (ইভেন্টস এপিআই), ডিসকর্ড (গেটওয়ে), সিগন্যাল (`signal-cli`), সিএলআই এবং মোবাইল (সুপ্ত) - এইচটিটিপি এন্ডপয়েন্ট: `/health/live`, `/health/ready`, `/health`, `/setup`, হোয়াটসঅ্যাপ/স্ল্যাক ওয়েবহুক **সিএলআই রেফারেন্স:** অন্তর্ভুক্ত `setup`, `auth login`, `run`, `service install/uninstall`, `start/stop/restart`, `status`, `health`, `voice status`, `pair`, `devices list/revoke`, `ask`/`chat`, `sandbox explain`, `grant path`, `revoke path`, `agents`, `capabilities`, `skills`, `plugins`, `memory`, `logs`, `upgrade`, `doctor`, `version`, `help`। **চ্যানেল কমান্ড:** `/compact`, `/new`, `/clear`, `/help`, `/whoami`, `/background`, `/tasks`, `/stop`, `/ultra`, `/sandbox`, `/soul`—সবই শেয়ার্ড ডিসপ্যাচারের মাধ্যমে চ্যানেল জুড়ে কাজ করে। **আর্কিটেকচার:** চারটি অ্যাপসহ আমব্রেলা প্রজেক্ট: `fermix_core` (এজেন্ট, প্রোভাইডার, টুল, মেমরি, সেটআপ, সিএলআই, অথ, ট্রেসিং), `fermix_channels` (টেলিগ্রাম, হোয়াটসঅ্যাপ, স্ল্যাক, ডিসকর্ড, সিগন্যাল, সিএলআই), `fermix_web` (ফিনিক্স: সেটআপ লাইভভিউ, হেলথ, ওয়েবহুক ইনগ্রেস) এবং `fermix_nif` (প্রসেস-গ্রুপ সিগন্যাল শিমের জন্য সি এনআইএফ)। ডেটা ফ্লো: চ্যানেল অ্যাডাপ্টার → ডিসপ্যাচার → মেইনএজেন্ট → ক্যাপাবিলিটি এক্সিকিউশন → প্রোভাইডার → এলএলএম → উত্তর। বিল্ট-ইন টুলের মধ্যে রয়েছে `shell`, `file_read`, `file_write`, `file_edit`, `glob_search`, `content_search`, `git_read`, `git_write`, `web_fetch`, `web_search`, `place_search` এবং `subagents`। স্কিল হলো আলাদা, ব্যবহারকারী-ইনস্টলযোগ্য ক্যাপাবিলিটি যার নিজস্ব নির্দেশনা এবং অনুমোদিত-টুল সীমানা রয়েছে। ফার্মিক্স আলফা (প্রি-১.০) স্ট্যাটাসে, এমআইটি-লাইসেন্সড এবং এলিক্সির ≥ ১.১৭ ও এরলাং/ওটিপি ≥ ২৮ প্রয়োজন।