Install and Initialize Mister Morph

1. Download and install

Recommended: install from GitHub release script.

curl -fsSL -o /tmp/install.sh https://raw.githubusercontent.com/quailyquaily/mistermorph/refs/heads/master/scripts/install-release.sh
sudo bash /tmp/install.sh

Optional: install from source.

go install github.com/quailyquaily/mistermorph@latest

2. Initialize required files and built-in skills

mistermorph install
# or
mistermorph install <dir>

This installs runtime files and built-in skills under ~/.morph/skills/ (or your custom <dir>).

3. Configure your LLM key

Edit ~/.morph/config.yaml:

llm:
  provider: "openai"
  endpoint: "https://api.openai.com/v1"
  model: "gpt-5.2"
  api_key: "YOUR_OPENAI_API_KEY_HERE"

4. Run a first local test

mistermorph run --task "Hello!"

If this works, your local initialization is done.

5. Connect Telegram and chat with the agent

5.1 Create a bot token

1. Open Telegram and chat with @BotFather.
2. Run /newbot and finish bot creation.
3. Copy the bot token.

5.2 Add Telegram config

Update ~/.morph/config.yaml:

telegram:
  bot_token: "YOUR_TELEGRAM_BOT_TOKEN_HERE"
  allowed_chat_ids: [] # add allowed chat ids here

5.3 Start Telegram mode

mistermorph telegram --log-level info

5.4 Start chatting

1. In Telegram, send /id to your bot and copy the returned chat id.
2. Add that id into telegram.allowed_chat_ids and restart mistermorph telegram --log-level info.
3. If you use the bot in a Telegram group, you may need to grant message-reading permissions, otherwise the bot may not receive group messages.
4. In private chat, send plain text directly; in groups, use /ask <task> or mention/reply to the bot.
5. Use /reset when you want to clear conversation history.

6. Next

For full and up-to-date documentation, check GitHub:

• Mister Morph docs on GitHub