Open PAIAgent-ը բարձր արագագործությամբ, առանց ավելորդ «ծանրության» (zero-bloat) բաց կոդով անձնական AI գործակալ է, որը ստեղծված է բացարձակ գաղտնիության և տեղական (local) աշխատանքի համար։ Նախագծված լինելով որպես թեթև այլընտրանք ռեսուրսատար ֆրեյմվորքերին՝ այն հրաժարվում է LangChain-ի պես բարդ աբստրակցիաներից՝ հօգուտ TypeScript-ի մաքուր աշխատանքի, վայրկյանից արագ մեկնարկի (sub-second cold start) և տվյալների լիարժեք ինքնավարության։
Github պրոեկտ։ https://github.com/nordevelopment/OpenPAIAgent
Պրոեկտի էջը։ https://nordevelopment.github.io/OpenPAIAgent
⚡ Հնարավորություններ
💬 Երկակի ինտերֆեյս. Cyberpunk ոճով գեղեցիկ Web UI + հեռահար մուտք Telegram բոտի միջոցով։
🧠 Մոդուլային համակարգային հրահանգներ (System Prompt). Գործակալի բնավորությունն ու հրահանգները դինամիկ կերպով հավաքվում են պարզ Markdown ֆայլերից (Agent.md, Identity.md, User.md, Memory.md)։
⚡ Դինամիկ հմտություններ (Dynamic Agent Skills). Խնայեք LLM կոնտեքստի տոկենները՝ մասնագիտացված հրահանգները բեռնելով ըստ անհրաժեշտության։ Հմտությունները պահվում են որպես մոդուլային Markdown ֆայլեր agents/<agentId>/skills/*.md հասցեում։ Երբ հարցումը համապատասխանում է վերնագրի բանալի բառերին (օրինակ՝ Keywords: amazon, wildberries, temu, code), հրահանգները դինամիկ ներարկվում են համակարգային prompt-ի մեջ։ Ներառում է պատրաստի հմտություններ՝
🛒 Էլեկտրոնային առևտուր և տեղական որոնում. Հատուկ URL կառուցվածքներ, գների սորտավորում և փարսինգի կանոններ Amazon-ի, Wildberries-ի, Ozon-ի, Temu-ի և List.am-ի համար։
💻 Ծրագրային ապահովման ճարտարագիտություն. Ռեֆակտորինգ, փնտրում-տեղադրում (debugging) և կոդի խիստ ոճի հրահանգներ։
🎨 Կոնտենտի ստեղծում և դիզայն. Քոփիրայթինգ, UI/UX ուղեցույցներ և նկարների գեներացման prompt-երի օպտիմալացում։
👁️ AI Vision. Կցեք նկարներ չաթում — AI-ն ավտոմատ կերպով փոխում է դրանց չափսը և փոխակերպում վիզուալ վերլուծության համար։
🔧 Գործիքների հզոր կատարում (Function Calling).
Ֆայլային համակարգի կառավարում. AI-ն կարող է ստեղծել, կարդալ, թարմացնել և ջնջել տեքստային ֆայլեր հատկացված տեղական
workspace/թղթապանակում։Web Scraper. Ներբեռնում է էջերը, հեռացնում ավելորդ HTML-ը և մաքրում տեքստը իրական ժամանակում վերլուծության համար։ Աջակցում է ինչպես արագ ստատիկ փարսինգ, այնպես էլ դինամիկ ռենդերինգ՝ SPA-ների համար (React, Vue, e-commerce կայքեր) ավտոմատ fallback-ով։
PDF Գեներատոր. AI-ն կարող է գրել custom HTML/CSS շաբլոններ և դրանք վերածել պրոֆեսիոնալ A4 PDF փաստաթղթերի, որոնք պահպանվում են անմիջապես workspace-ում։
Օֆիսային փաստաթղթերի գեներատոր. AI-ն կարող է ստեղծել կառուցվածքային Excel աղյուսակներ (
.xlsx)՝ սյուներով, տողերի ոճավորմամբ և բանաձևերով, ինչպես նաև Word փաստաթղթեր (.docx)՝ վերնագրերով, ոճավորված պարբերություններով, տեքստի հավասարեցմամբ և աղյուսակներով։Նկարների գեներացում. Ստեղծում է նկարներ Together AI կամ X.AI (Grok) API-ների միջոցով անմիջապես չաթում՝ խելացի fallback տրամաբանությամբ (եթե մեկ պրովայդերը կարգավորված չէ, ավտոմատ օգտագործվում է մյուսը)։
💾 Սեմանտիկ հիշողություն (SQLite + Vectors). Պահպանում է չաթի քննարկումներն ու պատմությունը SQLite-ում՝ ապահովելով սեմանտիկ վեկտորային որոնում թեթև sqlite-vec ընդլայնման միջոցով։
📋 Առաջադրանքների կառավարում և պլանավորող (Scheduler). Պլանավորեք ավտոմատացված ֆոնային առաջադրանքներ կամ գործարկեք դրանք ձեռքով։ Ներառում է ֆոնային առաջադրանքների ավտոմատ կատարում (ստուգում է 60 վայրկյանը մեկ), կարգավիճակի իրական ժամանակում հետևում UI-ում և Telegram-ով ակնթարթային ծանուցումներ։
🧠 Ճարտարապետական հիմնական որոշումներ
Open PAIAgent-ը կառուցված է թեթև, արդյունավետ և թափանցիկ AI ճարտարագիտության վրա․
Ինչո՞ւ առանց LangChain / LlamaIndex-ի
Վիճակի ամբողջական կառավարում (Complete State Control). Գործակալի ճանաչողական ցիկլը (think-act-evaluate) գրված է մաքուր TypeScript-ով, ինչը ապահովում է LLM գործիքների կանչի և պատմության վիճակի ամբողջական կառավարում։
Վայրկյանից արագ մեկնարկ. Backend-ը մեկնարկում է 1 վայրկյանից քիչ ժամանակում և ծախսում է ընդամենը ~50-100 ՄԲ RAM։
Աուդիտի հնարավորություն. Մաքուր, ընթեռնելի կոդը՝ առանց բարդ աբստրակցիաների, հեշտացնում է prompt-երի և գործիքների թեստավորումն ու սխալների ուղղումը։
Խելացի Հիբրիդային RAG և Հիշողություն
Օգտագործում է տեղական SQLite տվյալների բազա՝ զուգորդված թեթև
sqlite-vecընդլայնման հետ վեկտորային embedding-ների համար։Միավորում է սեմանտիկ վեկտորային որոնումը բանալի բառերով որոնման հետ (
LIKEհարցումներ)՝ ապահովելով կոնտեքստի բարձր ճշգրտություն առանց արտաքին տվյալների բազաների կախվածության (pgvector, Qdrant կամ Pinecone անհրաժեշտ չեն)։
💡 Ում համար է նախատեսված այս նախագիծը
Այս նախագիծը նախատեսված է բոլոր նրանց համար, ովքեր ցանկանում են ունենալ անձնական AI ասիստենտ, որը կարող է կառավարել տեղական ֆայլերը, որոնումներ անել ցանցում, գեներացնել նկարներ և հաղորդակցվել հարմարավետ Web ինտերֆեյսի կամ հեռահար՝ Telegram բոտի միջոցով։
🔒 100% Self-Hosted և Գաղտնի
OpenPAIAgent-ը ամբողջությամբ աշխատում է ձեր տեղական համակարգչի կամ սեփական սերվերի վրա։ Չաթերի ամբողջ պատմությունը, կարգավորումները և workspace-ի փաստաթղթերը պահվում են տեղական SQLite տվյալների բազայում։ Ձեր անձնական տվյալները երբեք չեն հեռանում ձեր համակարգչից, և դուք լիարժեք վերահսկում եք, թե որ արտաքին API-ներն են կանչվում (օրինակ՝ OpenRouter կամ Together AI)։
🔓 Ամբողջովին Բաց կոդ (Open Source)
Կառուցված է մաքուր TypeScript-ով և վեբ տեխնոլոգիաներով MIT լիցենզիայի ներքո։ Չկան ծանր ֆրեյմվորքեր (ինչպիսին է LangChain-ը) կամ ծածուկ հետևող համակարգեր։ Դուք ունեք լիարժեք թափանցիկություն, կարող եք հեշտությամբ ուսումնասիրել ելակետային կոդը և ազատորեն փոփոխել կամ ընդլայնել գործակալի ֆունկցիոնալությունը։
🛠️ Տեխնոլոգիաներ (Tech Stack)
Backend: Node.js, Fastify (ավելի արագ և թեթև, քան Express-ը), TypeScript
Frontend: EJS, Vanilla CSS (Cyberpunk թեմա), Vanilla JS
Տվյալների բազա:
better-sqlite3&sqlite-vecընդլայնումՄեդիա մշակում:
sharp(օպտիմալացնում է նկարները AI մուտքագրման համար)HTTP, Scraping & PDF:
axios+cheerio+puppeteer(headless Chrome)Telegram ինտեգրում:
telegraf
⚙️ Տեղադրում և Կարգավորում
Նախապայմաններ
Node.js (v20.x կամ ավելի բարձր)
npm (v9.x կամ ավելի բարձր)
1. Կլոնավորել և տեղադրել կախվածություններըgit clone https://github.com/nordevelopment/OpenPAIAgentcd OpenPAIAgentnpm install
(Այլընտրանքային տարբերակով կարող եք ներբեռնել ZIP արխիվը անմիջապես GitHub-ից):
Գործարկել հավելվածը:
# Կառուցել և գործարկել սերվերըnpm start# Մշակողների համար (Dev mode՝ hot reloading-ով)npm run dev# Վերասկզբնավորել/զրոյացնել SQLite տվյալների բազայի սխեմանnpm run db:reset# Միայն build հրամանի գործարկումnpm run build
Սերվերը կգործարկվի[http://127.0.0.1:3000](http://127.0.0.1:3000)հասցեով։
Բացեք այն։ Առաջին գործարկման ժամանակ (կամ կարգավորումների ֆայլերի բացակայության դեպքում) դուք ավտոմատ կվերահասցեավորվեք կարգավորումների էջ։
🔒 ԱնվտանգությունPAIAgent-ը ներառում է ներառված անվտանգության գործիքներ՝ ձեր սերվերը, ֆայլերը և API հաշվեկշիռը պաշտպանելու համար, երբ այն տեղադրված է հեռահար սերվերում։ Այս կարգավորումները կարող են կոնֆիգուրացվել ինչպես առաջին մեկնարկի ժամանակ, այնպես էլ հետագայում Web Settings Panel-ից (
/settingsէջում)։HTTP Basic Auth. Պաշտպանեք Web UI-ն և API endpoint-ները գաղտնաբառով։ Սահմանեք
APP_PASSWORD(և ըստ ցանկությանAPP_USER) ձեր.envֆայլում կամ Settings UI-ում։APP_PASSWORD-ը դատարկ թողնելն անջատում է աուտենտիֆիկացիան (օպտիմալ է local localhost-ի համար)։Telegram Bot Whitelist. Սահմանափակեք մուտքը դեպի Telegram բոտ։ Սահմանեք
ALLOWED_TELEGRAM_USER_IDSփոփոխականը.env-ում կամ Settings UI-ում՝ ստորակետով բաժանված Telegram User ID-ների ցանկով, որպեսզի կանխեք չարտոնված օգտատերերի մուտքը։Strict Path Validation. AI-ի ֆայլային բոլոր գործողությունները (read, write, delete) խստորեն ստուգվում են
path.relativeհամեմատությամբ, որպեսզի AI-ն չկարողանա դուրս գալ հատկացվածworkspace/թղթապանակից։Safe Agent Directory Routing. Գործակալների պրոֆիլների թղթապանակների գործողությունները զտում են բոլոր մուտքային ID-ները՝ կանխելով Path Traversal-ը
agents/թղթապանակից դուրս։Secure Cookies & Sessions. Session ID-ները գեներացվում են Node-ի
crypto.randomUUID()ֆունկցիայով, ხოლო session cookie-ները պաշտպանված ենsameSite: 'lax'և պայմանական secure flag-երով։
📸 Սքրինշոթեր
🚀 Տեղադրման և հնարավորությունների ցուցադրման տեսանյութhttps://www.youtube.com/watch?v=rcRkP_UiDRo
⚖️ Համեմատություն. Open PAIAgent-ն ընդդեմ «Ծանր» այլընտրանքներիՄինչ այլ self-hosted AI ինտերֆեյսներ պահանջում են ծանր միջավայրեր (Docker, բազմակոնտեյներային տվյալների բազաներ և այլն), Open PAIAgent-ը օպտիմալացված է տեղական արագագործության և ռեսուրսների խնայողության համար․
Պարամետր
Open PAIAgent
Open WebUI / LibreChat
RAM-ի ծախս
~50-100 ՄԲ
1.5 ԳԲ+ (Open WebUI) / 1 ԳԲ+ (LibreChat)
Մեկնարկի ժամանակ
Վայրկյանից արագ (< 1վ)
30-60 վայրկյան (Docker-ի դեպքում)
Կախվածություններ
Զրո (միայն Node.js և npm)
Docker, Python, PostgreSQL, Redis և այլն
Տվյալների բազա
Embedded SQLite (
sqlite-vec-ով)Արտաքին ծանր DB սերվերներ
Նպատակային օգտագործում
Անձնական AI ասիստենտ, ֆայլերի մշակում, web scraping
Բազմաօգտատեր enterprise համակարգեր
Հեղինակ: Նորայր Պետրոսյան (Norayr Petrosyan)





Comments (2)