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/OpenPAIAgent

    cd OpenPAIAgent

    npm 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)