Mister Morph
LANG EN
EN JA ZH
MENU

[ Agent ]

Install Deploy

[Aqua]

What's Aqua Install Aqua

[Others]

Coe

[ INSTALL // FROM ZERO TO TELEGRAM ]

Install and Initialize Mister Morph

This page covers the fastest path: install binary, install agent requirements, set API key, run once, then chat in Telegram.

1. Download and install

Recommended: install from GitHub release script.

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

The installer also supports:

  • bash install-release.sh <version-tag>
  • INSTALL_DIR=$HOME/.local/bin bash install-release.sh <version-tag>

Optional: install from source.

go install github.com/quailyquaily/mistermorph/cmd/mistermorph@latest

2. Install agent requirements and built-in skills

mistermorph install
# or
mistermorph install &lt;dir&gt;

The install command installs required files and built-in skills under ~/.morph/skills/ (or a specified directory via <dir>).

3. Set up your API key

You can run without a config.yaml by using environment variables:

export MISTER_MORPH_LLM_API_KEY=&#34;YOUR_OPENAI_API_KEY_HERE&#34;
# Optional explicit defaults:
export MISTER_MORPH_LLM_PROVIDER=&#34;openai&#34;
export MISTER_MORPH_LLM_MODEL=&#34;gpt-5.2&#34;

Mister Morph also supports Azure OpenAI, Anthropic Claude, AWS Bedrock, and others (see assets/config/config.example.yaml for more options). If you prefer file-based config, use ~/.morph/config.yaml.

4. One-time run

mistermorph run --task &#34;Hello!&#34;

If this works, your local quick start 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: &#34;YOUR_TELEGRAM_BOT_TOKEN_HERE&#34;
  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: