Ars Umbris কী?
Ars Umbris হলো typed knowledge-এর জন্য একটি নমনীয়, agent-native IDE। এটি জ্ঞান, type, skill, tool এবং UI component-কে পরস্পরের ওপর নির্ভরশীল, composable repository-তে একত্র করে।
প্রকল্পটি এই repository-গুলোকে একটি একক typed graph হিসেবে পড়ে। এটি field ও reference যাচাই করে এবং এরপর এমন diagnostic প্রদান করে, যার ওপর agent-রা কাজ করতে পারে। মানুষ ও agent একই primitive এবং SDK ব্যবহার করে tool তৈরি, view যোগ এবং application পরিবর্তন করতে পারে।
Ars Umbris বর্তমানে একটি early alpha পর্যায়ে রয়েছে, তাই bug ও breaking change প্রত্যাশা করুন। বর্তমানে এটি শুধুমাত্র macOS সমর্থন করে।
Architecture কীভাবে একসঙ্গে কাজ করে
Ars Umbris তিনটি প্রধান layer-এ সংগঠিত। এগুলো বুঝলে system configure বা extend করার সময় কোথায় দেখতে হবে তা নির্ধারণ করা সহজ হয়।
1. au-engine
au-engine হলো typed file substrate-এর ওপর তৈরি cross-repository graph engine। এটি repository-গুলোর file index করে এবং সেগুলোকে একটি typed, queryable, live graph-এ রূপান্তর করে।
এই engine Markdown ও YAML file-এর জন্য একটি custom typing language-ও বাস্তবায়ন করে। আরও বিস্তারিত জানতে au-engine.md পড়ুন।
2. au-host
au-host হলো Electron host application। এটি graph-এর ওপর typed projection বা view mount করে এবং typed data-এর ওপর configuration-driven composition সমর্থন করে।
এই composition-গুলো সম্পাদনাযোগ্য এবং মানুষ ও agent উভয়ের মাধ্যমে পরিচালিত হতে পারে। Host-এর documentation-এর জন্য au-host.md দেখুন।
3. au-mcp
au-mcp extensible agent layer প্রদান করে। এটি MCP-এর মাধ্যমে typed tool ও skill প্রকাশ করে এবং adapter-এর মাধ্যমে আপনার পছন্দের agent harness-এর সঙ্গে interface করে।
MCP layer সম্পর্কে আরও জানতে au-mcp.md পড়ুন।
Installation-এর প্রস্তুতি
Installation process-এ দুটি directory ব্যবহার করা হয়:
~/arsumbris/-এ একাধিক Ars Umbris repository রাখা হয়।~/.arsumbris/-এ Ars Umbris configuration file রাখা হয়।
প্রকল্পটি শুধুমাত্র macOS-এ চলে এবং এখনও সক্রিয় development-এ রয়েছে, তাই system-এ পরিবর্তন করার আগে prerequisite পর্যালোচনা করুন। প্রয়োজনীয় software ও setup-এর ক্রম সম্পর্কে repository-র বর্তমান installation instruction-ই authoritative source।
Entry-Point Repository Install করুন
README-তে নিচের instruction ব্যবহার করে agent-কে installation সম্পন্ন করতে বলার পরামর্শ দেওয়া হয়েছে:
অনুগ্রহ করে আমাকে Ars Umbris install করতে সাহায্য করুন।
1) আগে থেকে না থাকলে দুটি folder তৈরি করুন:
- ~/arsumbris/ এ একাধিক repository থাকবে।
- ~/.arsumbris/ এ configuration থাকবে।
2) Entry-point repository clone করুন:
git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris
গন্তব্যটি আগে থেকেই থাকলে এগিয়ে যাওয়ার আগে তা পরিদর্শন করুন; overwrite করবেন না।
3) ~/arsumbris/arsumbris/INSTALL.md পড়ে সেখানে দেওয়া বর্তমান setup process অনুসরণ করুন।
Prerequisite যাচাই করুন এবং আমার machine-এ কী পরিবর্তন প্রয়োজন তা আগে ব্যাখ্যা করুন।গুরুত্বপূর্ণ safety step হলো clone করার আগে বিদ্যমান ~/arsumbris/arsumbris directory পরিদর্শন করা। বিদ্যমান checkout overwrite করবেন না। Repository পাওয়ার পর INSTALL.md খুলে সেখানে নথিভুক্ত বর্তমান instruction-এর ক্রম অনুসরণ করুন।
Repository-র বর্তমান Setup Process অনুসরণ করুন
- নিশ্চিত করুন যে আপনি macOS ব্যবহার করছেন।
- আগে থেকে না থাকলে
~/arsumbris/এবং~/.arsumbris/তৈরি করুন। ~/arsumbris/arsumbrisআগে থেকেই আছে কি না যাচাই করুন।- না থাকলে
git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbrisদিয়ে repository clone করুন। - আগে থেকেই থাকলে প্রতিস্থাপন না করে তা পরিদর্শন করুন।
~/arsumbris/arsumbris/INSTALL.mdপড়ুন।- ফাইলটিতে উল্লেখিত prerequisite যাচাই ও install করুন; প্রয়োগের আগে প্রস্তাবিত machine পরিবর্তন পর্যালোচনা করুন।
INSTALL.md-তে নথিভুক্ত ক্রমে বাকি setup step সম্পন্ন করুন।
Ars Umbris সক্রিয় development-এ থাকায় third-party source-এর পুরোনো setup instruction-এর ওপর নির্ভর করা এড়িয়ে চলুন। আপনি যে version install করছেন, তার জন্য checkout করা repository-র installation guide ব্যবহার করুন।
Basic Usage-এর ধারণা
Ars Umbris typed knowledge ও capability-সমৃদ্ধ repository-কে কেন্দ্র করে তৈরি। একটি repository-তে knowledge, type definition, skill, tool এবং UI component থাকতে পারে। Repository অন্য repository-র ওপরও নির্ভর করতে পারে, ফলে বিভিন্ন project-এ capability ও knowledge পুনর্ব্যবহার করা যায়।
উচ্চ পর্যায়ে একটি সাধারণ workflow এমন হয়:
- সম্পর্কিত repository-গুলো
~/arsumbris/-এর অধীনে রাখুন বা clone করুন। au-engine-কে ওই repository-গুলোর file substrate index করতে দিন।- সংযুক্ত data, field ও reference নিয়ে কাজ করতে তৈরি হওয়া typed graph ব্যবহার করুন।
- Graph-এর ওপর projection ও view mount করতে
au-hostব্যবহার করুন। au-mcpএবং MCP adapter-এর মাধ্যমে একটি agent harness সংযুক্ত করুন।- Diagnostic পরিদর্শন, tool তৈরি, view যোগ এবং application পরিবর্তনের জন্য agent বা মানব user ব্যবহার করুন।
README কোনো একক sample project বা command-line workflow নির্ধারণ করে না। আপনার নির্দিষ্ট command এবং উপলভ্য projection INSTALL.md-তে বর্ণিত setup ও আপনার সংযুক্ত repository-গুলোর ওপর নির্ভর করবে।
MCP-এর মাধ্যমে Agent-এর সঙ্গে কাজ করা
Ars Umbris Model Context Protocol-এর মাধ্যমে একটি agent harness-এর সঙ্গে সংযুক্ত হওয়ার জন্য তৈরি। au-mcp layer typed tool ও skill প্রদান করে, আর adapter আপনার নির্বাচিত harness-এর সঙ্গে এই capability সংযুক্ত করে।
এর ফলে agent application তৈরিতে ব্যবহৃত একই underlying primitive ও SDK নিয়ে কাজ করতে পারে। বাস্তবে, আপনার installation-এ উপলভ্য capability ও configuration-এর সীমার মধ্যে agent tool তৈরি, view যোগ এবং app পরিবর্তনে অংশ নিতে পারে।
উন্নত টিপস ও নিরাপত্তা সংক্রান্ত বিবেচনা
রিপোজিটরিগুলোকে কম্পোজযোগ্য রাখুন
জ্ঞান ও সক্ষমতাগুলো এমন রিপোজিটরিতে সংগঠিত করুন, যেগুলো পুনর্ব্যবহার ও সংযুক্ত করা যায়। ক্রস-রিপোজিটরি নির্ভরতা প্রকল্পের মডেলের একটি কেন্দ্রীয় অংশ। তাই রিপোজিটরিগুলোকে বিচ্ছিন্ন ফোল্ডার হিসেবে না দেখে একটি টাইপযুক্ত গ্রাফের অংশ হিসেবে বিবেচনা করুন।
ডায়াগনস্টিককে প্রতিক্রিয়া হিসেবে ব্যবহার করুন
ইঞ্জিন টাইপযুক্ত গ্রাফজুড়ে ফিল্ড ও রেফারেন্স পরীক্ষা করে। টাইপযুক্ত Markdown, YAML বা সংশ্লিষ্ট রিপোজিটরি কনটেন্ট সম্পাদনা করার সময়, বিশেষ করে কোনো এজেন্ট পরিবর্তন করার ক্ষেত্রে, এর ডায়াগনস্টিকগুলোকে প্রতিক্রিয়া হিসেবে বিবেচনা করুন।
লেয়ারের ডকুমেন্টেশন পড়ুন
আচরণ বোঝার প্রয়োজন হলে সংশ্লিষ্ট লেয়ারের ডকুমেন্টেশন দেখুন: ইঞ্জিন, হোস্ট, অথবা MCP এজেন্ট লেয়ার।
পরিবর্তন প্রয়োগের আগে পর্যালোচনা করুন
ইনস্টলেশন প্রম্পটে কোনো প্রয়োজনীয় মেশিন পরিবর্তন করার আগে তা ব্যাখ্যা করার সুপারিশ করা হয়েছে। এজেন্টদের রিপোজিটরি বা কনফিগারেশন পরিবর্তনের অনুমতি দেওয়ার ক্ষেত্রেও একই সতর্ক পদ্ধতি অনুসরণ করুন।
বর্তমান নিরাপত্তা মডেল বিবেচনায় রাখুন
Ars Umbris আপনার মেশিনে কোড চালায় এবং বর্তমানে কোনো স্যান্ডবক্সিং নেই। প্রকল্পটি ব্যবহারের আগে SAFETY.md পর্যালোচনা করুন, বিশেষ করে এজেন্ট সংযুক্ত করার সময় বা এমন রিপোজিটরি নিয়ে কাজ করার সময়, যেগুলোর ওপর আপনার সম্পূর্ণ নিয়ন্ত্রণ নেই।
উপসংহার
Ars Umbris একটি টাইপযুক্ত জ্ঞানের পরীক্ষামূলক IDE হিসেবে টাইপযুক্ত ক্রস-রিপোজিটরি গ্রাফ, Electron-ভিত্তিক হোস্ট এবং একটি MCP এজেন্ট লেয়ারকে একত্র করে। শুরু করতে, দুটি কনফিগারেশন ডিরেক্টরি প্রস্তুত করুন, বিদ্যমান ফাইল ওভাররাইট না করে এন্ট্রি-পয়েন্ট রিপোজিটরি ক্লোন করুন এবং এর বর্তমান INSTALL.md অনুসরণ করুন। ইনস্টল হয়ে গেলে, রিপোজিটরি, প্রজেকশন, টুল, স্কিল ও এজেন্ট কীভাবে একসঙ্গে কাজ করে তা অন্বেষণ করুন—এবং প্রকল্পটির আলফা অবস্থা ও আনস্যান্ডবক্সড এক্সিকিউশন মডেল মনে রাখুন।