Začíname
Elowen je asistent, ktorého prevádzkujete na vlastnom serveri. Použijete ho v prehliadači, v CLI elowen alebo v podporovaných chatovacích kanáloch. Vie pracovať s Projektmi a zapnutými pluginmi a zadávať cielené úlohy sub-agentom.
Nastavte Elowen
Spusťte inštalátor na hostiteľovi s Debianom alebo Ubuntu. Vyžiada si licenčný kľúč skrytým zadaním a nainštaluje Node.js 22.19 alebo novší, ak na hostiteľovi chýba alebo je starší:
curl -fsSL https://<licence-server>/hooks/licensing/v1/install.sh | bash
Inštalátor overí kľúč skôr, než na hostiteľovi čokoľvek zmení, pripraví služby a v tom istom behu spustí sprievodcu nastavením. Sprievodca vytvorí prvého administrátora, zaregistruje voliteľný Projekt, pripojí poskytovateľa AI a model, uloží Vaše predvoľby a ponúkne voliteľné embeddingy pamäte a podporu language servera.
Pri inštalácii bez obsluhy nastavte ELOWEN_LICENCE_KEY v prostredí zo svojho úložiska tajomstiev a odovzdajte ELOWEN_INSTALL_ARGS s --unattended. Kľúč nikdy nedávajte na príkazový riadok: dostane sa do histórie shellu aj do zoznamu procesov.
Bez použiteľnej licencie zostane démon uzamknutý a webová aplikácia namiesto prihlásenia zobrazí licenčnú stránku. Aktiváciu, ochrannú lehotu a umiestnenie licenčného súboru opisuje článok Licencia.
Keď sa nastavenie skončí, otvorte adresu webového rozhrania, ktorú sprievodca vypíše na konci, alebo spustite terminálový chat príkazom elowen. Prvé spustenie elowen na serveri vypíše odkaz na schválenie prihlásenia v prehliadači a uloží osobný API token, ktorý môžete odvolať v Účet > API tokeny. Nastavenie neskôr zmeníte príkazom elowen setup.
Ak potrebujete inštaláciu skontrolovať, spustite elowen doctor.
Pripojte svoj počítač
Elowen vie pracovať aj na Vašom vlastnom počítači s Linuxom, macOS alebo Windows. Prihláste sa do webovej aplikácie, otvorte Účet > Počítače a zvoľte Kopírovať inštalačný príkaz; stránka vyberie príkaz pre systém, na ktorom beží Váš prehliadač. Príkaz vložte do terminálu na tom počítači; v Windows do PowerShellu. Windows vyžadujú Windows 10 22H2 alebo Windows 11. Podrobnosti: CLI.
Pošlite prvú požiadavku
Začnite niečím, čo sa dá ľahko skontrolovať:
List the files in my current Project and summarize its README.
Aké nástroje Elowen môže použiť, závisí od Vášho účtu, zvoleného Projektu, zapnutých pluginov a oprávnení k nástrojom.
Projekty a prístup
Projekt dáva Elowen prístup k zaregistrovanému repozitáru alebo pracovnému adresáru. Projekty registrujú administrátori a určujú, ktoré účty ich môžu používať. Registrácia existujúceho repozitára alebo pracovného adresára v ňom žiadne súbory nevytvorí ani nezmaže.
Spravované Projekty bežia vo vlastnom trvalom prostredí, ktoré sa spustí pri vytvorení Projektu. Pri ostatnej práci s repozitárom sa dá použiť git worktree. Voliteľné prepojenie s GitHubom priradí Projektu jeho repozitár na GitHube, takže git a gh v termináli bežia pod Vašou identitou na GitHube.
Účty a delegovaná práca
Administrátori spravujú účty, prístup k Projektom, prístup k pluginom a oprávnenia k nástrojom. Delegovaná práca má rovnaké limity prístupu ako jej rodič a nemôže získať ďalšie oprávnenia.
Režim plánu odmieta nástroje, ktoré niečo menia, takže si postup prezriete skôr, než sa čokoľvek zmení: asistent smie zapisovať len do svojho súboru plánu a spúšťať shellové príkazy bez vedľajších účinkov, kým plán neschválite. Režim workflow koordinuje niekoľko vzájomne závislých sub-agentov. Elowen vie tiež zadať cielenú úlohu jednému sub-agentovi svojím nástrojom Delegate. Ani jeden z týchto režimov nepridáva ďalší prístup.
Pozrite Projekty, prostredia a GitHub, CLI a Slash príkazy.
Spustite a aktualizujte Elowen
elowen up
elowen status
elowen restart all
elowen update
Služby zastavíte príkazom elowen down. Ten uloží rozpracovanú prácu; --force pridajte len vtedy, keď potrebujete zastaviť okamžite.