Začínáme

Elowen je asistent, kterého provozujete na vlastním serveru. Použijete ho v prohlížeči, v CLI elowen nebo v podporovaných chatovacích kanálech. Umí pracovat s Projekty a zapnutými pluginy a zadávat cílené úlohy sub-agentům.

Nastavte Elowen

Spusťte instalátor na hostiteli s Debianem nebo Ubuntu. Vyžádá si licenční klíč skrytým zadáním a nainstaluje Node.js 22.19 nebo novější, pokud na hostiteli chybí nebo je starší:

curl -fsSL https://<licence-server>/hooks/licensing/v1/install.sh | bash

Instalátor ověří klíč dřív, než na hostiteli něco změní, připraví služby a v témže běhu spustí průvodce nastavením. Průvodce vytvoří prvního administrátora, zaregistruje volitelný Projekt, připojí poskytovatele AI a model, uloží Vaše předvolby a nabídne volitelné embeddingy paměti a podporu language serveru.

Při instalaci bez obsluhy nastavte ELOWEN_LICENCE_KEY v prostředí ze svého úložiště tajemství a předejte ELOWEN_INSTALL_ARGS s --unattended. Klíč nikdy nedávejte na příkazový řádek: dostane se do historie shellu i do seznamu procesů.

Bez použitelné licence zůstane démon uzamčený a webová aplikace místo přihlášení zobrazí licenční stránku. Aktivaci, ochrannou lhůtu a umístění licenčního souboru popisuje článek Licence.

Až nastavení skončí, otevřete adresu webového rozhraní, kterou průvodce vypíše na konci, nebo spusťte terminálový chat příkazem elowen. První spuštění elowen na serveru vypíše odkaz pro schválení přihlášení v prohlížeči a uloží osobní API token, který můžete odvolat v Účet > API tokeny. Nastavení později změníte příkazem elowen setup.

Pokud potřebujete instalaci zkontrolovat, spusťte elowen doctor.

Připojte svůj počítač

Elowen umí pracovat i na Vašem vlastním počítači s Linuxem, macOS nebo Windows. Přihlaste se do webové aplikace, otevřete Účet > Počítače a zvolte Kopírovat instalační příkaz; stránka vybere příkaz pro systém, na kterém běží Váš prohlížeč. Příkaz vložte do terminálu na tom počítači; ve Windows do PowerShellu. Windows vyžadují Windows 10 22H2 nebo Windows 11. Podrobnosti: CLI.

Pošlete první požadavek

Začněte něčím, co jde snadno zkontrolovat:

List the files in my current Project and summarize its README.

Jaké nástroje Elowen může použít, závisí na Vašem účtu, zvoleném Projektu, zapnutých pluginech a oprávněních k nástrojům.

Projekty a přístup

Projekt dává Elowen přístup k zaregistrovanému repozitáři nebo pracovnímu adresáři. Projekty registrují administrátoři a určují, které účty je mohou používat. Registrace existujícího repozitáře nebo pracovního adresáře v něm žádné soubory nevytvoří ani nesmaže.

Spravované Projekty běží ve vlastním trvalém prostředí, které se spustí při vytvoření Projektu. Pro ostatní práci s repozitářem lze použít git worktree. Volitelné propojení s GitHubem přiřadí Projektu jeho repozitář na GitHubu, takže git a gh v terminálu běží pod Vaší identitou na GitHubu.

Účty a delegovaná práce

Administrátoři spravují účty, přístup k Projektům, přístup k pluginům a oprávnění k nástrojům. Delegovaná práce má stejné limity přístupu jako její rodič a nemůže získat další oprávnění.

Režim plánu odmítá nástroje, které něco mění, takže si postup prohlédnete dřív, než se cokoli změní: asistent smí zapisovat jen do svého souboru plánu a spouštět shellové příkazy bez vedlejších účinků, dokud plán neschválíte. Režim workflow koordinuje několik vzájemně závislých sub-agentů. Elowen umí také zadat cílenou úlohu jednomu sub-agentovi svým nástrojem Delegate. Ani jeden z těchto režimů nepřidává další přístup.

Viz Projekty, prostředí a GitHub, CLI a Slash příkazy.

Spusťte a aktualizujte Elowen

elowen up
elowen status
elowen restart all
elowen update

Služby zastavíte příkazem elowen down. Ten uloží rozpracovanou práci; --force přidejte jen tehdy, když potřebujete zastavit okamžitě.

Další: Instalace