Indlela Yokusingatha Ngokwakho i-Whirl, Uhlelo Lokuxoxa lwe-AI Olugcwele

Yini i-Whirl?

I-Whirl iwuhlelo lwengxoxo lwe-AI olunezingxenye zonke, oluwumthombo ovulekile, olwakhiwe nge-Next.js ne-Convex. Iyikhodi esebenza ngemuva kwe-whirl.chat futhi itholakala ngaphansi kwelayisensi ye-MIT, ngakho ungayihlola, usebenzise eyakho inguqulo, noma ufake isandla ekuthuthukiseni kwayo.

Le phrojekthi ihlanganisa amamodeli amaningi e-AI, inkumbulo ehlala isikhathi eside, izinto ezihlelwayo, ucwaningo lwewebhu, amathuluzi enziwe ngokwezifiso, nezingxoxo ezigxile kubumfihlo endaweni eyodwa. Amamodeli adluliswa nge-OpenRouter, kanti i-Convex inikeza isizindalwazi, imisebenzi ye-backend, ukusakaza, nemisebenzi ehlelelwe isikhathi.

Izici Ezibalulekile

• Amamodeli amaningi ahamba phambili: Sebenzisa amamodeli aphezulu e-AI engxoxweni eyodwa futhi ulungise amazinga okucabanga kwawo.
• Izinto eziphilayo: Dala amadokhumenti, amashadi, namakhasi asebenzisanayo ahlala ehleleka kuphaneli eseceleni futhi angabiwa ngesixhumanisi.
• Amathuluzi namakhono: Xhuma amathuluzi angaphandle nge-MCP, okuhlanganisa ukuhlanganiswa okusebenzisa i-OAuth, futhi ufake amakhono anweba indlela i-Whirl esebenza ngayo.
• Inkumbulo yesikhathi eside: Gcina izintandokazi nomongo wamaphrojekthi kuzo zonke izingxoxo.
• Ulwazi lwamanje lwewebhu: Sesha iwebhu futhi ufunde amakhasi ukuze ukhiqize izimpendulo ezisekelwe emithonjeni yakamuva.
• Izingxoxo eziyimfihlo: Izingxoxo ezikhiyiwe zibethelwa kudivayisi yomsebenzisi ngephasiwedi iseva engakaze iyithole. Zisebenzisa amamodeli angagcini datha kuphela.
• Izici zokukhiqiza: I-Whirl ihlanganisa imodi ye-incognito, ukubeka imilayezo kulayini, ukufaka ngezwi, ukukhiqiza izithombe, okunamathiselwe kwamafayela, amafolda, nokwabelana.
• Isixhumi esibonakalayo esenziwa ngokwezifiso: Khetha imodi ekhanyayo noma emnyama, setha imibala yokugqamisa, futhi ufake i-Whirl njengohlelo lwewebhu lweselula.

Ubuchwepheshe Obusetshenzisiwe

Uhlelo lwewebhu olusetshenziswa ekukhiqizeni lusebenzisa i-Next.js 16, i-React 19, i-Tailwind CSS v4, ne-Motion. I-Convex inikeza i-backend, i-Clerk iphethe ukuqinisekiswa kobunikazi, kanti i-OpenRouter inikeza ukufinyelela kumamodeli nge-AI SDK. Indawo yokugcina ikhodi ihlelwe njengama-workspace e-Bun futhi ibhalwe nge-TypeScript.

Kudingeka kuphela i-Convex, i-Clerk, ne-OpenRouter ekusethweni okuyisisekelo. Ezinye izinsizakalo ziyazikhethela:

• Autumn yokukhokhisa
• Exa yokusesha iwebhu
• Supermemory yenkumbulo
• PostHog ne-Axiom yezibalo zokusetshenziswa
• Braintrust yokulandelela
• Resend ye-imeyili
• Median yomenzeli wosizo

Uma isevisi ozikhethela yona ingalungiselelwanga, i-Whirl ifihla isici esinikwa amandla yileyo sevisi kunokuba idinge ukuthi isebenze ukuze uhlelo luqalise.

Okudingekayo Ngaphambili

Ngaphambi kokufaka i-Whirl, lungisa lokhu okulandelayo:

• Bun efakiwe kukhompyutha yakho
• I-akhawunti yamahhala ye-Convex
• Uhlelo lokusebenza lwe-Clerk
• Ukhiye we-API we-OpenRouter
• i-Git yokukopisha indawo yokugcina ikhodi

Isinyathelo 1: Kopa Futhi Faka i-Whirl

Kopa indawo yokugcina ikhodi, ngena enkombeni yayo, bese ufaka konke okudingekayo kuma-workspace nge-Bun:

git clone https://github.com/whirlchat/whirl.git
cd whirl
bun install

Isinyathelo 2: Dala i-Convex Backend

Ngena kuphakheji ye-backend bese uqala inqubo yokuthuthukisa ye-Convex:

cd packages/backend
bunx convex dev

Ekuqaleni, i-Convex izokuqondisa ekudaleni iphrojekthi nokusatshalaliswa kokuthuthukisa. Gcina le nqubo isebenza ukuze izinguquko ze-backend zivumelaniswe ngesikhathi sokuthuthukisa.

Isinyathelo 3: Lungisa Izimfihlo Ze-Backend

Vula enye i-terminal ku-packages/backend. Faka isizinda somkhiphi we-Clerk JWT nokhiye we-OpenRouter API endaweni ye-Convex:

bunx convex env set CLERK_JWT_ISSUER_DOMAIN https://your-instance.clerk.accounts.dev
bunx convex env set OPENROUTER_API_KEY sk-or-v1-...

Shintsha amanani ayisibonelo ufake iziqinisekiso ezivela kuma-akhawunti akho e-Clerk ne-OpenRouter. Amadokhumenti anemininingwane okuzibambela achaza ithemplethi ye-Clerk JWT edingwa yi-Convex.

Ungafaki okhiye be-API noma izimfihlo zokuqinisekisa endaweni yokugcina ikhodi. Gcina izimfihlo ze-backend usebenzisa imiyalo yemvelo ye-Convex, kanye nezilungiselelo zewebhu zendawo kufayela lemvelo elifanele.

Isinyathelo 4: Lungisa Uhlelo Lwewebhu

Ngena kuhlelo lwewebhu lokukhiqiza bese udala ifayela lemvelo lendawo usebenzisa isibonelo esinikeziwe:

cd ../../apps/v2
cp .env.example .env.local

Vula i-.env.local bese ugcwalisa amanani amane adingekayo e-Convex ne-Clerk. Sebenzisa ifayela lesibonelo njengomthombo wamagama aguquguqukayo aqondile, kunokuba udale amagama amasha.

Isinyathelo 5: Qalisa Indawo Yokuthuthukisa

Buyela empandeni yendawo yokugcina ikhodi bese uqala umyalo wokuthuthukisa:

cd ../..
bun run dev

Uma izinsizakalo sezisebenza, vula i-localhost:3000. Ngena ngohlelo lwe-Clerk olulungiselelwe bese uqala ingxoxo.

Ukusetshenziswa Okuyisisekelo

Qala Ingxoxo

Faka isicelo ebhokisini lokubhala lengxoxo bese usithumela kumodeli elungiselelwe. Isaziso sokuqala esilula singaqinisekisa ukuthi uhlelo lwewebhu, ukuqinisekiswa kobunikazi, i-Convex backend, noxhumano lwe-OpenRouter kusebenza ndawonye:

Chaza izingxenye eziyinhloko zalolu hlelo ngamaphuzu amahlanu amafushane.

Sebenza Namamodeli

I-Whirl yakhelwe ukunikeza ukufinyelela kumamodeli amaningi ahamba phambili nge-OpenRouter ngaphakathi kwengxoxo. Ungasebenzisa namazinga okucabanga alungisekayo lapho esekelwa uhlelo nemodeli ekhethiwe.

Dala Futhi Uthuthukise Izinto

Buza u-Whirl ukuthi akhiqize idokhumenti, ishadi, noma ikhasi elisebenzisanayo. Lezi zinto ezihlala zishintshashintsha zihlala zihleleka kuphaneli eseceleni futhi zingabiwa ngesixhumanisi, okwenza zifanele imiphumela edinga ukuthuthukiswa okuqhubekayo kunempendulo eyodwa yengxoxo.

Sebenzisa Amafayela, Izwi, Nokuhlela

U-Whirl usekela okunamathiselwe kwamafayela nokufakwa kwezwi ngaphezu kwemilayezo ebhalwe. Izingxoxo zingahlelwa zibe amafolda, kanti izici zokwabelana zenza umsebenzi okhethiwe utholakale kwabanye.

Ukuqonda I-Repository

I-monorepo iqukethe izinhlelo zokusebenza eziningana kanye ne-backend eyabiwe:

• apps/v2: Uhlelo lwewebhu lwe-Next.js olusetshenziswa ngu-Whirl futhi olusetshenziswa ekukhiqizeni.
• apps/console: Ikhonsoli yokuphatha esekelwe ku-Vite yamamodeli, ukuhlanganiswa, namakhono.
• apps/mobile: Uhlelo lwendabuko olwakhiwe nge-Expo.
• apps/waitlist: Ikhasi elizimele lohlu lokulinda.
• apps/remotion: Ukwakhiwa kwamavidiyo okukhangisa.
• apps/legacy: Uhlelo lwewebhu lwangaphambilini, olugcinelwe ukubhekiselwa kulo kodwa olungasanakekelwa.
• packages/backend: I-schema ye-Convex, imisebenzi, nepayiphi ye-AI.
• docs: Imihlahlandlela yokuzisingatha, yokumisa, neyokwakheka kohlelo.
• brand: Amalogo, imibala, amabhanela, nezithonjana zohlelo.

Ekuthuthukisweni kwewebhu kwamanje, gxila ku-apps/v2 naku-packages/backend. Gwema ukwakha umsebenzi omusha ku-apps/legacy, ngoba ayisanakekelwa.

Amathiphu Athuthukile

Engeza Izinsizakalo Ongazikhetha Kancane Kancane

Qala ngokumisa okudingekayo kwe-Convex, Clerk, ne-OpenRouter. Ngemva kokuba ukugeleza okuyisisekelo kwengxoxo kusebenza, engeza abahlinzeki ongabakhetha oyedwa ngesikhathi. U-Whirl ufihla ngokuzenzakalelayo ukusebenza okhiye bakho abadingekayo abangekho, okwenza kube lula ukusebenzisa ukufakwa okuncane.

Bheka umhlahlandlela wokumisa we-repository ukuze uthole okuguquguqukayo kwemvelo okuhlobene nokukhokhisa, ukusesha, inkumbulo, ukuhlaziya, ukulandelela, i-imeyili, nokwesekwa.

Khetha Imodi Yobumfihlo Efanele

Sebenzisa imodi ye-incognito uma ungafuni ukuhamba komsebenzi kwengxoxo okuvamile nokuphikelela. Ukuze uthole ukuvikeleka okuqinile, izingxoxo ezikhiyiwe zibethelwa kudivayisi ngephasiwedi iseva engakaze iyibone, futhi ziphendulwa kuphela amamodeli angagcini idatha. Khumbula ukuthi ukulahlekelwa yiphasiwedi egcinwe eklayentini kungathinta ikhono lakho lokufinyelela okuqukethwe okubethelwe.

Hlola Ipayiphi Yemilayezo

Lapho ulungisa izinkinga zokusakaza, izingcingo zamathuluzi, noma ukuziphatha kwemodeli, funda umhlahlandlela wokwakheka kohlelo wephrojekthi. Uchaza ukuthi umlayezo uhamba kanjani usuka kumqambi uye kumodeli bese ubuya. Ukuqaliswa okufanele kuhlukaniswe ikakhulu phakathi kohlelo lwewebhu lokukhiqiza ne-backend ye-Convex.

Lungiselela Ukukhiqizwa Ngokucophelela

Ukuqalisa okusheshayo kwakha indawo yokuthuthukisa. Ngaphambi kokushicilela esidlangalaleni, landela umhlahlandlela ophelele wokuzisingatha, kuhlanganise nemiyalelo yawo yethempulethi ye-Clerk JWT nokushicilela kokukhiqiza.

Faka Isandla Ngendlela Ephephile

Ngaphambi kokuvula i-pull request, buyekeza umhlahlandlela wokufaka isandla wephrojekthi ukuze ufunde izimiso nokuhlolwa. Landela ikhodi yokuziphatha, futhi bika izinkinga zokuphepha usebenzisa inqubo eku-SECURITY.md kunokusebenzisa udaba olusesidlangalaleni.

Isiphetho

U-Whirl unikeza isiqalo esinezici eziningi sendawo yokusebenza yengxoxo ye-AI ezisingathwa nguwe, uhlanganisa isixhumi esibonakalayo se-Next.js ne-backend ye-Convex, ukuqinisekiswa kobunikazi kwe-Clerk, kanye nokufinyelela kumamodeli e-OpenRouter. Qala ngezinsizakalo ezintathu ezidingekayo, uqinisekise ingxoxo yasendaweni ku-localhost:3000, bese unika amandla ukusesha, inkumbulo, ukuhlaziya, ukukhokhisa, nokunye ukuhlanganiswa ongakukhetha ngokwezidingo zokushicilela kwakho.