My First Agent

by @KOVY

🤖 My First Agent Za jedno odpoledne máš vlastního AI agenta. Zdarma. Vlastní jméno, paměť, osobnost. Webchat v prohlížeči. Dostupný z mobilu přes Tailscale....

README

🤖 My First Agent

Za jedno odpoledne máš vlastního AI agenta. Zdarma.

Vlastní jméno, paměť, osobnost. Webchat v prohlížeči. Dostupný z mobilu přes Tailscale. Volitelně Discord bot 24/7. Žádné programování, žádná kreditka.


🚀 Rychlý start

Krok 0: Nainstaluj Tailscale (bezpečný vzdálený přístup)

Tailscale ti dá soukromou IP adresu (100.x.x.x) — agent pak bude dostupný odkudkoli, nejen z localhost.

SystémPostup
WindowsStáhni: tailscale-setup-1.94.2.exe
Macbrew install tailscale nebo tailscale.com/download/mac
Linuxcurl -fsSL https://tailscale.com/install.sh | sh && sudo tailscale up
tailscale ip   # poznamenej si svou 100.x.x.x adresu

Krok 1: Nainstaluj Node.js 22+

Linux:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs

Mac:

brew install node

Windows (PowerShell jako Admin):

winget install OpenJS.NodeJS.LTS

Zavři a znovu otevři terminál. Ověř: node --version (musí být 22+).

Krok 2: Nainstaluj Git + nastav PATH

# Git (Linux — Mac: xcode-select --install, Windows: winget install Git.Git)
sudo apt-get install -y git

# PATH pro npm globální balíčky (Linux/Mac)
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH="$HOME/.npm-global/bin:$PATH"
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc

Krok 3: Vyber si AI engine (zdarma)

Máš na výběr — oba fungují skvěle a jsou zdarma:

Varianta A: Gemini CLI (Google) ⭐ doporučujeme

npm install -g @google/gemini-cli
gemini    # přihlas se Google účtem v prohlížeči

Varianta B: Qwen Code (Alibaba)

npm install -g @qwen-code/qwen-code@latest
qwen      # napiš /auth → přihlas se v prohlížeči

Krok 4: Stáhni repo a nastav identitu agenta

mkdir -p ~/openclaw && cd ~/openclaw
git clone https://github.com/KOVY/my-first-agent.git
cd my-first-agent

Doporučeno — interaktivní setup skript:

bash scripts/setup.sh

Skript se tě zeptá na jméno agenta, styl a tvoje jméno — a za 30 sekund máš hotovo.

Nebo ručně:

cp examples/SOUL-example.md SOUL.md
cp examples/USER-example.md USER.md
nano SOUL.md   # dej agentovi jméno a osobnost
nano USER.md   # napiš kdo jsi ty

Krok 5: Spusť agenta! 🎉

V terminálu (Gemini nebo Qwen):

gemini    # nebo: qwen

Napiš: Přečti si SOUL.md a USER.md a představ se mi.

Nebo jako webchat (OpenClaw):

npm install -g openclaw
openclaw gateway start

Otevři prohlížeč → http://localhost:18789


📱 Přístup z mobilu (přes Tailscale)

Díky Tailscale (Krok 0) je agent dostupný i z mobilu, tabletu nebo jiného počítače:

http://100.x.x.x:18789

(místo 100.x.x.x dosaď svou Tailscale IP — zjistíš ji příkazem tailscale ip)


📁 Co je v repozitáři

SouborCo to je
SOUL.mdOsobnost tvého agenta — jméno, hodnoty, styl
USER.mdInformace o tobě — jak tě agent oslovuje
IDENTITY.mdVizitka agenta
AGENTS.mdPracovní pravidla a návyky
TOOLS.mdTvoje lokální poznámky k nástrojům
memory/Složka pro agentovu paměť
skills/Dovednosti — rozšíření co agent umí
scripts/setup.shInteraktivní nastavení agenta (jméno, styl, jazyk)
examples/Ukázkové soubory a config šablona

🧠 Jak to funguje

  1. Agent přečte SOUL.md → ví kdo je
  2. Přečte USER.md → ví kdo jsi ty
  3. Přečte AGENTS.md → ví jak pracovat
  4. Ukládá si poznámky do memory/ → pamatuje si

Žádná magie, žádný cloud. Všechno je na tvém počítači.


💬 Komunita — KOWEX Discord

Připoj se, sdílej co tvůj agent umí, získej tipy, potkej další lidi s agenty:

👉 Discord — KOWEX Community

Alan Spark (AI CEO) tě přivítá a pomůže s pokročilým nastavením.

Discord bot setup: DISCORD-BOT-SETUP.md nebo bash scripts/setup-discord-bot.sh


❓ Časté problémy

ProblémŘešení
command not found: nodeNainstaluj Node.js 22+ (Krok 1), restart terminálu
command not found: gemininpm install -g @google/gemini-cli, restart terminálu
command not found: qwennpm install -g @qwen-code/qwen-code@latest, restart terminálu
command not found: openclawnpm install -g openclaw, restart terminálu
Agent neodpovídá českyPřidej do SOUL.md: **Jazyk:** čeština
Agent nezná mé jménoVyplň USER.md a restartuj agenta
Tailscale IP nezobrazujeUjisti se že Tailscale je přihlášen: tailscale status

📞 Pomoc


📜 Licence

MIT — používej, upravuj, sdílej.


Vytvořeno s ❤️ firmou KOWEX Co. Holding — 14 firem, 14 AI agentů, 0 lidských zaměstnanců.

Community

No comments yet.

Related Lobsters