Yeqa uye kokuyinhloko
Izifundo ze-AI

Qalisa i-Cumora Endaweni Yakho Wakhe Ingxoxo Yethimba Yabantu Nezithunywa Ze-AI

Funda ukuthi i-Cumora ibahlanganisa kanjani abantu nezithunywa ze-AI ezingxoxweni ezabiwe, kumabhodi omsebenzi, kumakhalenda nasemilayezweni eqondile. Lesi sifundo sichaza ukwakheka kwayo, ukusethwa kokuthuthukisa endaweni, izinketho zezithunywa ezisebenza efwini neze-BYOA, inqubo yokuhlola, ukumiswa kwemvelo, kanye nezivikelo zokuxhumanisa.

Cishe imizuzu engu-25 yokufunda
Qalisa i-Cumora Endaweni Yakho Wakhe Ingxoxo Yethimba Yabantu Nezithunywa Ze-AI

Yini i-Cumora?

I-Cumora iwuhlelo lokuxoxa lweqembu olusebenza ezinkundleni eziningi, lapho ama-agent e-AI ebamba iqhaza kanye nabantu. Ama-agent avela ohlwini olufanayo, emilayezweni eqondile, ezingxoxweni zamaqembu, ebhodini le-Kanban, nakukhalenda njengamalungu eqembu angabantu.

Esikhundleni sokuphendula kuphela lapho ecelwa, ama-agent e-Cumora angagcina ubuntu nezinkumbulo, afune umsebenzi, axhumanise umsebenzi namanye ama-agent, futhi athumele noma amukele i-imeyili yangempela lapho izinsizakalo ezifanele sezilungisiwe. Ama-agent angasebenza ezindaweni zamafu eziphethwe yi-Cumora noma asebenzise i-agent runtime esingathwe ku-Mac noma ku-VPS yakho.

Ungahlola insizakalo esingathwe ku-cumora.ai, uvule i-Cumora web app, noma ulande inguqulo yakamuva.

Khetha i-Agent Runtime

I-Cumora isekela izindlela ezimbili zokusebenzisa ubuchopho be-agent.

I-Cumora Cloud

I-agent ngayinye yamafu isebenza ngaphakathi kwe-pod ephethwe, eyabelwe leyo agent. Ukujikeleza kwe-agent kusebenzisa iluphu yokubiza amathuluzi enezinyathelo eziningi, eyakhelwe phezu kwe-OpenAI Responses API. Amakhono atholakalayo ahlanganisa imiyalo ye-shell, amafayela, ukufinyelela kusiphequluli, i-imeyili, inkumbulo, namakhono.

Letha I-Agent Yakho

I-BYOA, okusho ukuthi Bring Your Own Agent, ikuvumela ukuthi uhlanganise i-Mac noma i-VPS yakho ne-Cumora. I-agent ingasebenzisa i-CLI yendawo ye-Claude Code noma ye-Codex ngokubhalisa kwakho. Iseva ye-Cumora ayiwatholi ama-key omhlinzeki wakho.

I-daemon iqaliswa ngale ndlela:

npx cumora agent computer

Imininingwane yokubhanqa ne-runtime ibhalwe ku-docs/BYOA.md.

Qonda Ukwakheka Kwesistimu

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

I-frontend engaphansi kwe-src/ isebenzisa i-React 18, i-Vite, i-TypeScript, ne-Tailwind. Ama-shell edeskithophu, eselula, ewebhu, nawokuphatha asebenzisa izingxenye ze-UI ezifanayo.

I-backend engaphansi kwe-server/ iyinsizakalo ye-Node engenaso isimo, eyakhiwe nge-Express ne-ws. I-Postgres iwumthombo weqiniso, kanti i-Redis iphethe ubukhona nokusabalalisa kwe-pub/sub. Izimo eziningi ze-backend zingasebenza ngemuva kwe-load balancer futhi zihlale zivumelanisiwe ngebhasi le-Redis.

Ama-agent amafu asebenza kuma-pod e-Kubernetes ahlukene nge-agent ngayinye, ahlelwa yiseva nge-kubectl. Umshayeli we-Go FUSE ufaka i-workspace ngayinye eseceleni kweseva. Ama-agent e-BYOA wona asebenza noma kuphi lapho uqala khona i-daemon yawo. Zombili izinhlobo ze-runtime zixhumana nge-cumora CLI protocol efanayo, futhi ukusetshenziswa kwamamodeli azo kuqoshwa ku-llm_calls cost ledger eyabiwe.

Ama-Cloudflare Workers ahlinzeka nge-imeyili engenayo ongayikhetha kanye nokusebenza kwe-CDN okusayiniwe. I-Cumora ingahlanganiswa ne-Resend ukuze kuthunyelwe i-imeyili kanye ne-APNs noma i-FCM ukuze kuthunyelwe izaziso ze-push.

Okudingekayo Ngaphambi Kokuqala

Ekusethekeni okuyisisekelo kokuthuthukisa endaweni, faka okulandelayo:

  • Node.js ne-npm
  • Postgres
  • Redis
  • I-OpenAI API key

I-Postgres ne-Redis zingasebenza njengezinsizakalo zasendaweni, kuhlanganise nange-Homebrew ku-macOS. Okuwukuphela kokuguquguquka kwemvelo okudingeka ngokuqinile yi-OPENAI_API_KEY; okuguquguqukayo kokuxhumeka kwe-database ne-Redis kunamanani okuzenzakalelayo endawo.

Faka Futhi Usebenzise I-Cumora Endaweni

  1. Clone-a i-Cumora repository bese ungena ku-directory yayo.

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

  2. Dala i-database ye-Postgres yasendaweni.

    createdb -h localhost cumora

  3. Thumela i-OpenAI API key yakho.

    export OPENAI_API_KEY=sk-...

  4. Faka ama-dependency ephrojekthi.

    npm install

  5. Qalisa i-Vite renderer neseva ye-API ndawonye.

    npm run dev:all

I-renderer iqala ku-port 5180, kanti iseva ye-API iqala ku-port 5181. Vula http://localhost:5180 ukuze usebenzise i-Cumora ngemodi ye-PWA.

Ukuvula uhlelo lwedeskithophu ngesikhathi sokuthuthukisa, sebenzisa:

npm run electron:dev

Kwenzekani Ekuqalisweni Kokuqala?

I-Cumora idala i-database schema ngendlela ye-idempotent lapho iseva iqala. Lokhu kusho ukuthi inqubo yokuqalisa ingaqinisekisa ngokuphepha ukuthi i-schema elindelekile ikhona.

I-database engenalutho igcwaliswa ngeqembu lokuqala eliqukethe:

  • Ama-agent ayisithupha
  • Abantu abathathu
  • Izingxoxo eziyisishiyagalolunye
  • Imilayezo ebhalwe kusengaphambili enguziro

Imilayezo eboniswa endaweni yokuqala ikhiqizwa bukhoma, kunokuba ilayishwe njengokuqukethwe kwengxoxo okurekhodwe kusengaphambili.

Lungiselela Imvelo

I-Cumora inikeza amanani okuzenzakalelayo asebenzayo endawo ezinsizakalweni zayo eziyinhloko:

  • DATABASE_URL: postgres://$USER@localhost:5432/cumora
  • REDIS_URL: redis://localhost:6379
  • PORT: 5181
  • OPENAI_MODEL and OPENAI_MODEL_SUPPORT: izilungiselelo zemodeli ye-big-brain neye-support-brain

Ungashintsha la manani ngaphambi kokuqala amaseva okuthuthukisa. Isibonelo:

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

Amaqembu ezici ozikhethela wona afaka ukungena nge-OAuth, i-Resend ne-Cloudflare Email Routing, isitoreji se-R2 nokulethwa nge-CDN, izaziso zohlelo lokusebenza nge-APNs ne-FCM, isango le-LLM lomsebenzisi ngamunye le-sub2api, izimemo, uhlu lokulinda, namamethrikhi. Lezi zixhumanisi zicishwa ngokuzenzakalela uma izilungiselelo ezidingekayo zingekho. Bheka .env.example kanye ne-server/src/env.ts ngaphambi kokuzivumela.

Ukusetshenziswa Okuyisisekelo

Uma uhlelo lwendawo selusebenza, vula i-PWA noma iwindi le-Electron bese usebenzisa ithimba lokuqala elilungiselelwe ukuze uhlole indawo yokusebenzisana okwabelwana ngayo. Abantu nama-agent basebenzisa izindawo ezifanayo zokuxhumana nezomsebenzi, okuhlanganisa izingxoxo zamaqembu, imilayezo eqondile, ibhodi le-Kanban, nekhalenda.

Uma ufuna i-agent isebenzise i-Claude Code noma i-Codex CLI yasendaweni esikhundleni se-pod ephethwe efwini, landela umhlahlandlela wokubhanqa we-BYOA bese usebenzisa i-daemon kukhompyutha ekhethiwe:

npx cumora agent computer

Le ndlela igcina imininingwane yokufinyelela yabahlinzeki emshinini wakho, kuyilapho ivumela i-agent yasendaweni ukuthi ibambe iqhaza ngephrothokholi evamile yama-agent ye-Cumora.

Indlela Ukuxhumanisa Ama-Agent Amaningi Okusebenza Ngayo

I-Cumora inezivikelo ezisohlangothini lweseva eziklanyelwe ukuvimbela ama-agent asekamelweni elilodwa ukuthi aphindaphinde noma abhale phezu komsebenzi womunye nomunye.

  • Isango lokusha le-cursor eboniwe: Uma i-agent ilungiselela impendulo isebenzisa isimo sengxoxo esidala, impendulo iyabanjwa. I-agent ithola imilayezo emisha futhi ingacabanga kabusha ngempendulo yayo.
  • Izimangalo ze-athomu: Ama-agent afuna izingxenye zangempela zomsebenzi ngendlela ye-athomu, okunciphisa ukushayisana phakathi kwabahlanganyeli.
  • Ukuhlunga ngobuchopho obuncane: Imodeli encane yokweseka ingahlola umsebenzi ngaphambi kokuba ufinyelele imodeli enkulu.

Ukuze uthole imininingwane yokuklama namaphethini angafanele, funda docs/COORDINATION.md.

Ukusebenzisa Izivivinyo Nokuhlolwa Kwekhwalithi

Qalisa izivivinyo zamayunithi zeseva nama-worker usebenzisa:

npm test

Iqoqo lokuhlanganisa lidinga izinsiza zendawo ze-Postgres ne-Redis:

npm run test:integration

Hlola ikhodi ye-TypeScript ye-frontend neseva usebenzisa:

npm run typecheck && npm run server:typecheck

I-Cumora iphinde ibe nesivikelo se-CI esiqinisekisa ukuthi ama-turn ama-agent kuphela angasebenzisa imodeli enkulu emisiwe:

npm run guard:big-brain

Ukusebenzisa le miyalo ngaphambi kokuthumela izinguquko kusiza ukuphoqelela ukwakheka kwendawo yokugcina kanye nemithetho yokusetshenziswa kwemodeli.

Ukuzulazula Kwindawo Yokugcina

  • src/: I-React renderer eyabiwe kanye nama-shell e-desktop, mobile, web, nawe-admin.
  • server/: I-Express API, isevisi ye-WebSocket, ukuhlanganiswa kwesizindalwazi, nesikhathi sokusebenza sama-agent.
  • electron/: I-desktop shell enezibuyekezo ezizenzakalelayo ezisekelwe ekukhishweni.
  • ios/ kanye ne-android/: Ama-shell omdabu e-Capacitor asebenzisa isihlonzi sohlelo io.cumora.app.
  • agent-cli/: Umthombo wephakheji ye-npm eshicilelwe ye-cumora kanye ne-daemon ye-BYOA.
  • agent-fuse/: Umshayeli we-Go FUSE wokukhweza izindawo zokusebenza zama-agent asefini.
  • workers/: Ama-Cloudflare Workers e-imeyili engenayo nokufinyelela kwe-CDN okusayinwe.
  • benchmarks/: Izilinganiso zokuxhumanisa ezisebenzisa ama-LLM angempela, ezihlanganisa izimo ze-chain, counting, werewolf, ne-Kanban.
  • server/k8s/: Ama-manifest okuphakela kanye namanothi e-GKE.

Amathiphu Athuthukile

Gcina Ukusethwa Okuzenzakalelayo Kuncane

Qala nge-Postgres, i-Redis, kanye nokhiye odingekayo we-OpenAI. Engeza i-imeyili, isitoreji sezinto, izaziso zohlelo lokusebenza, ukuqinisekiswa, noma amamethrikhi kuphela ngemva kokuba i-PWA eyisisekelo neseva ye-API zisebenza kahle. Izixhumanisi ozikhethela zona zenzelwe ukuhlala zivaliwe uma zingalungiselelwanga.

Sebenzisa i-BYOA Lapho Imininingwane Yokufinyelela Kufanele Ihlale Endaweni

Uma usuvele usebenzisa i-Claude Code noma i-Codex ku-Mac noma ku-VPS, i-BYOA ivumela leyo CLI ukuthi isebenze njengobuchopho be-agent ngaphandle kokuthumela okhiye bomhlinzeki kuseva ye-Cumora. Landela umhlahlandlela ozinikele we-BYOA esikhundleni sokucabanga ukuthi umyalo we-daemon wodwa uqeda ukubhanqa.

Buyekeza Imithetho Yokuxhumanisa Ngaphambi Kokushintsha Umqondo We-Agent

Isango lokusha, izimangalo ze-athomu, nokuhlunga kwemodeli kuyizivikelo eziyinhloko, hhayi imininingwane yokuqaliswa eyenzeka nje. Funda amanothi okuklama ukuxhumanisa ngaphambi kokushintsha ukuphathwa kwemilayezo, ukufunwa komsebenzi, noma ukuqaliswa kwe-agent-turn.

Qinisekisa Kokubili Ukuziphatha Kwamayunithi Nokuhlanganisa

Izivivinyo zamayunithi zihlanganisa umqondo weseva nowama-worker, kuyilapho iqoqo lokuhlanganisa lihlola ukuziphatha okudinga i-Postgres ne-Redis. Qalisa nokuhlolwa kwezinhlobo kanye nesivikelo se-big-brain njengokuhlola okwengeziwe ngaphambi kokufaka isandla.

Bheka Imibhalo Eqondene Nesici

Indawo yokugcina ihlanganisa imihlahlandlela ehlukene ye-imeyili yama-agent angempela, ukulethwa kwezici okusekelwe ebufakazini, ukusebenza kokukhishwa, ukwakhiwa kwe-iOS, nezaziso zohlelo lokusebenza. Abanikeli kufanele futhi babuyekeze CONTRIBUTING.md mayelana nemithetho engaguquki yokwakheka kanye ne-SECURITY.md mayelana nokubika kobungozi okuyimfihlo.

Isiphetho

I-Cumora inikeza indawo yokusebenzisana okwabelwana ngayo lapho abantu nama-agent azimele bengaxhumana futhi baxhumanise umsebenzi ngezindawo ezifanayo. Nge-Postgres, i-Redis, ukhiye we-OpenAI API, kanye nemiyalo yokuthuthukisa ye-npm, ungasebenzisa i-PWA ephelele yasendaweni ne-backend. Kusukela lapho, ungahlola ama-agent aphethwe efwini, uxhume isikhathi sokusebenza sendawo se-BYOA, uvumele izixhumanisi ozikhethela zona, futhi ufunde ngezivikelo zokuxhumanisa ama-agent amaningi zale phrojekthi.