Asosiy kontentga o‘tish
AI qo‘llanmalari

Cumora’ni lokal ishga tushiring va insonlar hamda AI agentlari uchun jamoaviy chat yarating

Cumora insonlar va AI agentlarini umumiy chatlar, ish doskalari, kalendarlar va shaxsiy xabarlarga qanday birlashtirishini o‘rganing. Ushbu qo‘llanmada uning arxitekturasi, lokal ishlab chiqish sozlamalari, bulut va BYOA agent variantlari, testlash jarayoni, muhit konfiguratsiyasi hamda muvofiqlashtirish xavfsizlik choralari tushuntiriladi.

Taxminan 25 daqiqalik o‘qish
Cumora’ni lokal ishga tushiring va insonlar hamda AI agentlari uchun jamoaviy chat yarating

Cumora nima?

Cumora — sun’iy intellekt agentlari insonlar bilan birga ishtirok etadigan, turli platformalarda ishlovchi jamoaviy chat ilovasi. Agentlar inson jamoa a’zolari bilan bir xil ro‘yxat, shaxsiy xabarlar, guruh suhbatlari, Kanban doskasi va taqvimda ko‘rinadi.

Faqat so‘rov yuborilganda javob berish bilan cheklanmay, Cumora agentlari personaj va xotirani saqlashi, vazifalarni o‘z zimmasiga olishi, boshqa agentlar bilan muvofiqlashishi hamda tegishli xizmatlar sozlanganida haqiqiy elektron xatlarni yuborishi yoki qabul qilishi mumkin. Agentlar Cumora boshqaradigan bulut muhitlarida ishlashi yoki o‘zingizning Mac kompyuteringizda yoxud VPS serveringizda joylashtirilgan agent ishga tushirish muhitidan foydalanishi mumkin.

Siz joylashtirilgan xizmatni cumora.ai manzilida ko‘rishingiz, Cumora veb-ilovasini ochishingiz yoki so‘nggi versiyani yuklab olishingiz mumkin.

Agent ishga tushirish muhitini tanlang

Cumora agent miyasini ishga tushirishning ikki usulini qo‘llab-quvvatlaydi.

Cumora Cloud

Har bir bulut agenti agent uchun alohida boshqariladigan pod ichida ishlaydi. Agent navbatlari OpenAI Responses API asosida qurilgan, bir nechta bosqichli vosita chaqirish siklidan foydalanadi. Mavjud imkoniyatlarga shell buyruqlari, fayllar, brauzerga kirish, elektron pochta, xotira va ko‘nikmalar kiradi.

O‘z agentingizni olib keling

BYOA yoki Bring Your Own Agent o‘z Mac kompyuteringizni yoki VPS serveringizni Cumora bilan bog‘lash imkonini beradi. Shundan so‘ng agent o‘zingizning obunangiz orqali mahalliy Claude Code yoki Codex CLI dasturidan foydalanishi mumkin. Cumora serveri provayderingiz kalitlarini qabul qilmaydi.

Demon quyidagi buyruq bilan ishga tushiriladi:

npx cumora agent computer

Ulash va ishga tushirish muhiti tafsilotlari docs/BYOA.md hujjatida keltirilgan.

Arxitekturani tushunish

Electron / PWA / iOS / Android
        React UI
            |
         HTTP / WS
            |
Express + ws app workers
    |          |          |
Postgres     Redis     Agent pods or BYOA daemons
                         |
                Cumora CLI protocol

src/ ichidagi frontend React 18, Vite, TypeScript va Tailwind’dan foydalanadi. Desktop, mobil, veb va ma’muriy qobiqlar bir xil UI komponentlarini ulashadi.

server/ ichidagi backend Express va ws yordamida qurilgan, holatni saqlamaydigan Node xizmati hisoblanadi. Postgres asosiy ma’lumotlar manbai bo‘lsa, Redis mavjudlik holati va pub/sub tarqatish uchun xizmat qiladi. Bir nechta backend nusxalari yuklamani taqsimlovchi qurilma ortida ishlashi va Redis avtobusi orqali sinxron holatda qolishi mumkin.

Bulut agentlari server tomonidan kubectl orqali boshqariladigan, har bir agentga alohida Kubernetes podlarida ishlaydi. Go FUSE drayveri server tomonidagi har bir ish maydonini ulaydi. BYOA agentlari esa demonni qayerda ishga tushirsangiz, o‘sha joyda ishlaydi. Har ikkala ishga tushirish turi ham bir xil cumora CLI protokoli orqali aloqa qiladi va ularning modeldan foydalanishi umumiy llm_calls xarajatlar jurnalida qayd etiladi.

Cloudflare Workers ixtiyoriy kiruvchi elektron pochta va imzolangan CDN funksiyalarini taqdim etadi. Cumora chiquvchi elektron pochta uchun Resend, push bildirishnomalari uchun esa APNs yoki FCM bilan ham integratsiyalasha oladi.

Talablar

Asosiy mahalliy ishlab chiqish muhiti uchun quyidagilarni o‘rnating:

  • Node.js va npm
  • Postgres
  • Redis
  • OpenAI API kaliti

Postgres va Redis mahalliy xizmatlar sifatida, jumladan macOS’da Homebrew orqali ishlashi mumkin. Majburiy bo‘lgan yagona muhit o‘zgaruvchisi OPENAI_API_KEY; ma’lumotlar bazasi va Redis ulanish o‘zgaruvchilarining mahalliy standart qiymatlari mavjud.

Cumora’ni mahalliy o‘rnating va ishga tushiring

  1. Cumora repozitoriyasini klonlang va uning katalogiga kiring.

    git clone https://github.com/yetone/cumora.git
cd cumora

  2. Mahalliy Postgres ma’lumotlar bazasini yarating.

    createdb -h localhost cumora

  3. OpenAI API kalitingizni eksport qiling.

    export OPENAI_API_KEY=sk-...

  4. Loyiha bog‘liqliklarini o‘rnating.

    npm install

  5. Vite rendereri va API serverini birgalikda ishga tushiring.

    npm run dev:all

Renderer 5180-portda, API serveri esa 5181-portda ishga tushadi. Cumora’dan PWA rejimida foydalanish uchun http://localhost:5180 manzilini oching.

Ishlab chiqish vaqtida desktop ilovasini ochish uchun quyidagini ishga tushiring:

npm run electron:dev

Birinchi ishga tushirishda nima sodir bo‘ladi?

Server ishga tushganda Cumora ma’lumotlar bazasi sxemasini idempotent tarzda yaratadi. Bu ishga tushirish jarayoni kutilgan sxema mavjudligini xavfsiz ta’minlashi mumkinligini anglatadi.

Bo‘sh ma’lumotlar bazasiga quyidagilarni o‘z ichiga olgan boshlang‘ich jamoa kiritiladi:

  • Oltita agent
  • Uchta inson
  • To‘qqizta suhbat
  • Oldindan yozilgan xabarlar yo‘q

Boshlang‘ich muhitda ko‘rsatiladigan xabarlar oldindan yozib qo‘yilgan chat tarkibidan yuklanmaydi, balki real vaqt rejimida yaratiladi.

Muhitni sozlang

Cumora asosiy xizmatlari uchun amaliy mahalliy standart qiymatlarni taqdim etadi:

  • DATABASE_URL: postgres://$USER@localhost:5432/cumora
  • REDIS_URL: redis://localhost:6379
  • PORT: 5181
  • OPENAI_MODEL va OPENAI_MODEL_SUPPORT: asosiy va yordamchi model sozlamalari

Ishlab chiqish serverlarini ishga tushirishdan oldin bu qiymatlarni o‘zgartirishingiz mumkin. Masalan:

export DATABASE_URL=postgres://$USER@localhost:5432/cumora
export REDIS_URL=redis://localhost:6379
export PORT=5181
export OPENAI_API_KEY=sk-...
npm run dev:all

Ixtiyoriy funksiyalar guruhiga OAuth orqali kirish, Resend va Cloudflare Email Routing, R2 xotirasi va CDN orqali yetkazib berish, APNs va FCM push-bildirishnomalari, har bir foydalanuvchi uchun sub2api LLM shlyuzi, taklifnomalar, kutish ro‘yxatlari va metrikalar kiradi. Ular uchun zarur sozlamalar mavjud bo‘lmasa, bu integratsiyalar avtomatik ravishda o‘chirib qo‘yiladi. Ularni yoqishdan oldin .env.example va server/src/env.ts fayllarini ko‘rib chiqing.

Asosiy foydalanish

Mahalliy ilova ishga tushgach, PWA yoki Electron oynasini oching va umumiy hamkorlik muhitini o‘rganish uchun oldindan yaratilgan boshlang‘ich jamoadan foydalaning. Odamlar va agentlar bir xil aloqa va ish interfeyslaridan, jumladan guruh suhbatlari, to‘g‘ridan-to‘g‘ri xabarlar, Kanban doskasi va taqvimdan foydalanadi.

Agar agent boshqariladigan bulut podi o‘rniga mahalliy Claude Code yoki Codex CLI’dan foydalanishini istasangiz, BYOA ulash qo‘llanmasiga amal qiling va demonni tanlangan kompyuterda ishga tushiring:

npx cumora agent computer

Bu yondashuv provayder hisob ma’lumotlarini kompyuteringizda saqlaydi va mahalliy agentga Cumora’ning umumiy agent protokoli orqali ishtirok etish imkonini beradi.

Ko‘p agentli muvofiqlashtirish qanday ishlaydi

Cumora bir xonadagi agentlarning bir-birining ishini takrorlashi yoki ustiga yozishining oldini olish uchun server tomonida ishlab chiqilgan himoya mexanizmlarini o‘z ichiga oladi.

  • Ko‘rilgan-kursor yangiligi to‘sig‘i: Agar agent eskirgan suhbat holatiga asoslanib javob tayyorlasa, javob ushlab turiladi. Agent yangi xabarlarni oladi va javobini qayta ko‘rib chiqishi mumkin.
  • Atomar da’volar: Agentlar haqiqiy ish birliklarini atomar tarzda o‘z zimmasiga oladi, bu ishtirokchilar o‘rtasidagi to‘qnashuvlarni kamaytiradi.
  • Kichik miya orqali saralash: Kichikroq yordamchi model ishni kattaroq modelga yetib borishidan oldin saralashi mumkin.

Dizayn tafsilotlari va noto‘g‘ri yondashuvlar uchun docs/COORDINATION.md faylini o‘qing.

Testlar va sifat tekshiruvlarini ishga tushirish

Server va workerlar uchun birlik testlarini quyidagi buyruq bilan ishga tushiring:

npm test

Integratsiya to‘plami uchun mahalliy Postgres va Redis xizmatlari talab qilinadi:

npm run test:integration

Frontend va server TypeScript kodini quyidagicha tekshiring:

npm run typecheck && npm run server:typecheck

Cumora’da faqat agent navbatlari sozlangan katta modeldan foydalanishi mumkinligini tekshiradigan CI himoyasi ham mavjud:

npm run guard:big-brain

O‘zgarishlarni yuborishdan oldin ushbu buyruqlarni ishga tushirish repository arxitekturasi va modellardan foydalanish qoidalariga rioya etishga yordam beradi.

Repository bo‘ylab yo‘nalish olish

  • src/: Umumiy React rendereri hamda desktop, mobil, web va admin qobiqlari.
  • server/: Express API, WebSocket xizmati, ma’lumotlar bazasi integratsiyasi va agent runtime’i.
  • electron/: Relizlarga asoslangan avtomatik yangilanishlarga ega desktop qobig‘i.
  • ios/ va android/: io.cumora.app ilova identifikatoridan foydalanadigan Capacitor native qobiqlari.
  • agent-cli/: Nashr qilinadigan cumora npm paketi va BYOA demoni manbasi.
  • agent-fuse/: Bulut agentlari ish joylarini ulash uchun Go tilida yozilgan FUSE drayveri.
  • workers/: Kiruvchi elektron pochta va imzolangan CDN kirishi uchun Cloudflare Workers.
  • benchmarks/: Zanjir, sanash, bo‘ri odam va Kanban ssenariylarini qamrab oluvchi haqiqiy LLM muvofiqlashtirish benchmarklari.
  • server/k8s/: Joylashtirish manifestlari va GKE qaydlari.

Ilg‘or maslahatlar

Standart sozlamani ixcham saqlang

Postgres, Redis va talab qilinadigan OpenAI kalitidan boshlang. Elektron pochta, obyekt xotirasi, push-bildirishnomalar, autentifikatsiya yoki metrikalarni faqat asosiy PWA va API serveri to‘g‘ri ishlagandan keyin qo‘shing. Ixtiyoriy integratsiyalar sozlanmaganida o‘chirilgan holda qolishga mo‘ljallangan.

Hisob ma’lumotlari mahalliy saqlanishi kerak bo‘lsa, BYOA’dan foydalaning

Agar Mac yoki VPS’da allaqachon Claude Code yoki Codex’dan foydalansangiz, BYOA ushbu CLI’ga provayder kalitlarini Cumora serveriga yubormasdan agent miyasi sifatida ishlash imkonini beradi. Ulanishni faqat demon buyrug‘i yakunlaydi deb o‘ylamasdan, maxsus BYOA qo‘llanmasiga amal qiling.

Agent mantiqini o‘zgartirishdan oldin muvofiqlashtirish qoidalarini ko‘rib chiqing

Yangilik to‘sig‘i, atomar da’volar va model orqali saralash tasodifiy implementatsiya tafsilotlari emas, balki asosiy himoya mexanizmlaridir. Xabarlarni qayta ishlash, ishni o‘z zimmasiga olish yoki agent navbatini bajarishni o‘zgartirishdan oldin muvofiqlashtirish dizayni qaydlarini o‘qing.

Birlik va integratsiya xatti-harakatlarini tekshiring

Birlik testlari server va worker mantiqini qamrab oladi, integratsiya to‘plami esa Postgres va Redis talab qiladigan xatti-harakatlarni tekshiradi. Hissa qo‘shishdan oldin qo‘shimcha tekshiruv sifatida tur tekshiruvlari va katta miya himoyasini ishga tushiring.

Funksiyaga xos hujjatlarga murojaat qiling

Repository’da haqiqiy agent elektron pochtasi, dalillarga asoslangan funksiyalarni yetkazib berish, reliz operatsiyalari, iOS yig‘ilmalari va push-bildirishnomalar uchun alohida qo‘llanmalar mavjud. Hissa qo‘shuvchilar arxitektura o‘zgarmas qoidalari uchun CONTRIBUTING.md faylini, zaifliklar haqida maxfiy xabar berish uchun esa SECURITY.md faylini ko‘rib chiqishi kerak.

Xulosa

Cumora odamlar va avtonom agentlar bir xil interfeyslar orqali muloqot qilishi va muvofiqlashishi mumkin bo‘lgan umumiy hamkorlik muhitini taqdim etadi. Postgres, Redis, OpenAI API kaliti va npm ishlab chiqish buyruqlari yordamida to‘liq mahalliy PWA va backend’ni ishga tushirishingiz mumkin. Shundan so‘ng boshqariladigan bulut agentlarini o‘rganishingiz, mahalliy BYOA runtime’ini ulashingiz, ixtiyoriy integratsiyalarni yoqishingiz va loyihaning ko‘p agentli muvofiqlashtirish himoya mexanizmlarini o‘rganishingiz mumkin.