marveen

Marveen

AI csapatod, ami fut amíg te alszol.

Marveen egy AI asszisztens keretrendszer, ami Claude Code-ra épül. Saját AI csapatot építhetsz, akik Telegramon, Slacken vagy Discordon kommunikálnak veled, önállóan dolgoznak, és egymással is együttműködnek.

Marveen is a self-hostable agent harness for Claude Code: it runs a team of AI agents, each with its own chat channel (Telegram, Slack or Discord), persistent memory, scheduled tasks, and MCP tools, lets them delegate work to one another, and gives you a web dashboard to watch and steer them.

Funkciók

• AI Csapat: Több ágens, mindegyik saját csatornával (Telegram, Slack vagy Discord), személyiséggel és memóriával
• Mission Control: Web dashboard (http://localhost:3420) a csapat kezeléséhez
• Inter-agent kommunikáció: Az ágensek delegálhatnak egymásnak feladatokat
• Ütemezések: Cron-alapú feladatok automatikus futtatása
• Kanban: Feladattábla AI auto-bontással; Jira-szerű nézetek — swimlane (csoportosítás felelős vagy prioritás szerint), oszloponkénti WIP-limit, beakadt-kártya jelzés (card-aging), alfeladat-beágyazás és kártya-szerkesztő
• Heartbeat: Csendes háttér-monitorozás, csak fontosnál szól (naptár, email, kanban)
• Memória: Hot/Warm/Cold tier rendszer, hibrid kereséssel (FTS5 + vektor) és gráf nézettel
• MCP Connectorok: Gmail, Calendar, Drive, Notion, Slack és más szolgáltatások
• Skillek: Újrahasználható képességek az ágenseknek
• Öntanulás: Az ágensek automatikusan tanulnak a munkájukból és skill-eket hoznak létre

📚 Dokumentáció

Részletes, funkciónkénti leírások a docs/ mappában — mindegyik lap két szemszögből: 🎯 mit tud / miért érdekes + 🛠 hogyan működik.

Funkció	Lap
Heartbeat + fokozatos autonómia	docs/heartbeat-autonomy.md
Memória-rendszer (FTS5 + vektor + RRF)	docs/memory-system.md
Kanban (auto-breakdown, swimlane, WIP-limit, card-aging)	docs/kanban.md
Ügynök-flotta + inter-agent	docs/agent-fleet.md
Föderáció (több példány összekötése, dashboard-menüvel)	docs/federation.md
Skill-factory (öntanulás)	docs/skill-factory.md
Channels (Telegram / Slack / Discord)	docs/channels.md
Printing-press CLI-k	docs/printing-press-cli.md
Skool CLI	docs/skool-cli.md
connectors.hu	docs/connectors-hu.md
Vault & titkosítás	docs/vault.md
Dream-engine	docs/dream-engine.md
Háttér-feladatok	docs/background-tasks.md
Ütemezett feladatok	docs/scheduled-tasks.md
Költöztetés (másik gépre)	docs/MIGRATION.md
Beszélgetés-folytonosság	docs/conversation-continuity.md
Channel reply-guard	docs/channel-reply-guard.md
Telegram haladásjelző	docs/telegram-progress-indicator.md
Slack haladásjelző	docs/slack-progress-indicator.md
Új asszisztens onboarding	docs/onboarding-uj-asszisztens.md

Öntanulás & Seed-ek

Az ágensek automatikusan tanulnak a munkájukból: komplex feladat vagy hiba-recovery után újrahasznosítható skill-t (recept) írnak maguknak, a meglévőket pedig célzottan patch-elik. A skill-ek token-hatékonyan, 3 szinten töltődnek (progressive disclosure). A flotta-szintű skill-ek és ütemezett feladatok a seed-skills/ és seed-scheduled-tasks/ mappából terjednek minden telepítésre (idempotens: a meglévő testreszabást nem írja felül).

→ Részletek: docs/skill-factory.md

Memória rendszer

Minden ágens saját, réteges memóriával rendelkezik (hot / warm / cold / shared), SQLite-ban tárolva. A keresés hibrid: FTS5 full-text + szemantikus vektor (Ollama nomic-embed-text), RRF-fel fúzionálva. A memóriák salience decay-en mennek át (a régi, nem használt tételek halványulnak, de sosem törlődnek), és minden este napi napló készül. A PreCompact hook a kontextus-tömörítés előtt automatikusan elmenti a fontos döntéseket. A dashboardon gráf-nézet is van.

→ Részletek: docs/memory-system.md

Telepítés

macOS / Linux

cd ~
git clone --branch main https://github.com/Szotasz/marveen.git
cd marveen
./install.sh

Alapértelmezés szerint a dashboard a 3420-as porton indul (http://localhost:3420). Egyedi port beállításához:

./install-linux.sh --port 3421   # vagy: WEB_PORT=3421 ./install-linux.sh

Windows (WSL)

irm https://raw.githubusercontent.com/Szotasz/marveen/main/install-windows.ps1 | iex

Vagy manuálisan:

git clone --branch main https://github.com/Szotasz/marveen.git
cd marveen
.\install-windows.ps1

A Windows telepítő automatikusan beállítja a WSL-t (Windows Subsystem for Linux) és azon belül telepíti a Marveen-t.

Ha a PowerShell ablak bezárul / a telepítő nem jut túl a WSL+Ubuntu lépésen: nyisd meg az Ubuntu-t (Start menü → Ubuntu), majd a WSL Ubuntu shellben futtasd közvetlenül a Linux-telepítőt (a PowerShell wrapper megkerülése):

cd ~ && curl -fsSL https://raw.githubusercontent.com/Szotasz/marveen/main/install-linux.sh -o install.sh && bash install.sh

Ez a megbízható út, ha a wsl.exe/Windows-claude környezet összeakad.

A telepítő végigvezet a beállításokon:

1. Függőségek ellenőrzése és telepítése
2. Claude Code bejelentkezés
3. Telegram bot létrehozása
4. Személyes beállítások (a bot neve és a termék/márka neve)
5. Szolgáltatások indítása

Branding (saját márkanév)

A platform szabadon márkázható telepítéskor. Két, egymástól független beállítás:

Beállítás	Mi ez	Default
BOT_NAME	A fő ágens megjelenített neve (pl. MyAssistant)	Marveen
BRAND_NAME	A termék / rendszer neve a dashboard fejlécében (böngésző-cím, oldalsáv, mobil topbar)	BOT_NAME

A telepítő mindkettőt megkérdezi. Ha csak Entert nyomsz, minden marad Marveen (a viselkedés változatlan a meglévő telepítésekhez képest). Ha külön márkanevet adsz meg, a teljes felület és az OS szolgáltatás-azonosítók is azzal jönnek létre:

# Példa: az ágens neve "MyAssistant", a terméké "AcmeAI"
#   Mi legyen a botod neve? [Marveen]: MyAssistant
#   Mi a termék/márka neve? [MyAssistant]: AcmeAI

A .env-ben ezek a kulcsok jelennek meg (lásd .env.example):

BOT_NAME=MyAssistant
BRAND_NAME=AcmeAI
MAIN_AGENT_ID=myassistant   # belső ágens-azonosító (a BOT_NAME ASCII slug-ja)
SERVICE_ID=acmeai           # OS szolgáltatás-azonosító (a BRAND_NAME ASCII slug-ja)

A MAIN_AGENT_ID és SERVICE_ID értékeket a telepítő automatikusan származtatja; ritkán kell kézzel szerkeszteni. Ha a BRAND_NAME megegyezik a BOT_NAME-mel (a default), a SERVICE_ID megegyezik a MAIN_AGENT_ID-vel, így a launchd/systemd unit-nevek byte-azonosak a márkázatlan telepítéssel: a helyben történő frissítés nem törik el.

Használat

Dashboard

Nyisd meg: http://localhost:3420

Csatorna (Telegram, Slack vagy Discord)

A telepítés során választhatsz csatorna providert (Linuxon és macOS-en is). Az alapértelmezett a Telegram.

Telegram (alapértelmezett)

Írj a botodnak Telegramon -- Marveen válaszol.

Slack (alternatív)

Slack használatához a telepítő automatikusan végigvezet, de manuálisan is beállíthatod:

1. Hozz létre egy Slack App-ot a Slack API oldalon
2. Engedélyezd a Socket Mode-ot (Settings > Socket Mode > Enable)
3. Generálj egy App-Level Token-t (xapp-...) a connections:write scope-pal
4. Add hozzá a Bot Token Scopes-okat (OAuth & Permissions): chat:write, channels:read, files:write, files:read
5. Installáld az App-ot a workspace-edbe -- megkapod a Bot User OAuth Token-t (xoxb-...)
6. Hívd meg a botot a kívánt csatornába (/invite @BotNev)
7. A .env fájlban állítsd be:

   CHANNEL_PROVIDER=slack
   SLACK_BOT_TOKEN=xoxb-...
   SLACK_APP_TOKEN=xapp-...
   SLACK_CHANNEL_ID=C01234ABCDE
   

8. A Slack channel plugin automatikusan települ: slack@jeremylongshore/claude-code-slack-channel

Discord (alternatív)

A telepítő végigvezet (Linuxon és macOS-en is a 3. opció), de manuálisan is beállíthatod:

1. Hozz létre egy alkalmazást a Discord Developer Portalon
2. A Bot fülön add hozzá a botot és másold ki a tokent
3. Privileged Gateway Intents: kapcsold be a MESSAGE CONTENT INTENT-et
4. OAuth2 > URL Generator: bot scope, majd hívd meg a botot a szerveredre
5. Developer Mode-dal másold ki a csatorna ID-t és a saját (operátor) user ID-det
6. A .env fájlban állítsd be:

   CHANNEL_PROVIDER=discord
   DISCORD_BOT_TOKEN=...
   DISCORD_CHANNEL_ID=...
   OPERATOR_DISCORD_USER_ID=...
   

7. A Discord channel plugin automatikusan települ: discord@claude-plugins-official

Részletek (managed-settings allowlist, párosítás): docs/channels.md.

A csatorna váltáshoz futtasd újra a ./install.sh-t vagy szerkeszd a .env fájlt manuálisan.

Ágensek

A Csapat oldalon hozz létre új ágenseket. Mindegyik:

• Saját Telegram bot
• Saját személyiség (SOUL.md)
• Saját utasítások (CLAUDE.md)
• Saját memória és skillek

Telegram bot profilkép

A telepítő automatikusan generál egy pixel-art avatart és Telegramon elküldi neked a beállítási utasításokkal. Ha egyedi képet szeretnél:

1. Tedd a fájlt agents/<AGENT_NEVE>/avatar.png alá (png/jpg/jpeg/webp)
2. Indítsd újra a szolgáltatást (./scripts/stop.sh && ./scripts/start.sh)
3. Az install-flow újra elküldi az avatart a Telegram chatbe

Beállítás a Telegram botodra:

1. Nyisd meg a @BotFather chatet
2. Küld a /setuserpic parancsot
3. Válaszd ki a botodat a listából
4. Küldd be a kapott képet

A dashboardon (Csapat oldal) is cserélhetsz avatart: kattints a bot kártyájára, válassz a galériából vagy tölts fel sajátot -- a rendszer automatikusan elküldi a Telegram chatbe.

Ütemezések

Időzített feladatok és heartbeat monitorok beállítása:

• Lista, napi idővonal és heti nézet
• Feladat: mindig szól az eredménnyel
• Heartbeat: csendes ellenőrzés, csak fontosnál értesít

Vault & Titkosítás

Az MCP szerverek API kulcsait, tokenjeit és jelszavait egy titkosított Vault kezeli (AES-256-GCM), a master key macOS-en a Keychain-ben (Linuxon fájl-alapú fallback). A .mcp.json-ben csak vault:SECRET_ID referenciák állnak — a plaintext kulcsok nem hevernek olvashatóan. A dashboard Vault-oldalán kezelheted a titkokat, a Scan & Import megtalálja a meglévő plaintext kulcsokat.

→ Részletek: docs/vault.md