Set up MyAgens in five minutes

MyAgens is a self-hosted fleet of Claude Code agents that runs on your own machine. You command it from Telegram or the web panel, and nothing risky runs without your approval. This guide gets you from nothing to a working fleet in about five minutes.

What you need

• A machine you control (your Mac, a Windows PC, or a Linux box or VPS) that can stay on.
• A terminal, and permission to install software on that machine.
• A way to reach Claude: either a Claude Pro or Max subscription (you log in during setup), or an Anthropic API key. MyAgens runs real Claude Code agents, so one of these is required. You can also point it at a local or OpenAI-compatible model instead.
• A Telegram account. The browser setup (macOS, Linux, and Windows) walks you through creating the bot and recognizes you when you press START, with no IDs to look up. Only the terminal-only wizard (headless boxes, SSH) needs a bot token and your numeric user ID up front; the BotFather and user ID guides cover both.

You do not need Docker. MyAgens runs as a plain background process, and the installer sets up its dependencies (Node, git, the Claude CLI) for you.

1. Install MyAgens

Pick your platform and run the installer:

• macOS or Linux: see Install on macOS or Install on Linux.
• Windows: see Install on Windows.

On every platform the installer does the mechanical part in the terminal, then finishes on a guided setup page in your browser (the step-by-step shows every screen); a terminal-only wizard covers headless boxes and SSH. Either way it installs the dependencies, configures your bot and Claude, and can run MyAgens as a background service.

2. Open the web panel

The browser setup finishes signed in to the panel. The terminal wizard prints a local panel URL and a one-click login link at the end instead. Either way you land on your fleet, its memory, and the activity log.

3. Connect Telegram

Setup connects two things: a bot token from @BotFather and your Telegram user ID. The user ID is your access barrier: MyAgens only takes orders from the IDs on the allow-list and silently ignores everyone else. The browser setup detects your ID when you press START in the bot's chat and confirms with a ✅ message; the terminal wizard asks for it instead (how to find it). Create the bot in How to create your first Telegram bot with BotFather; BotFather's Mini App makes it a one-minute form, and while you are there you can turn on Restrict bot usage so Telegram itself blocks everyone but you.

4. Send your first command

Ask the fleet for something small to confirm the loop works end to end, for example a quick summary of a file or a one-line change in a project you point it at. You approve the plan, it runs, and you see the result.

That is the whole loop: you ask, the fleet proposes, you approve, it acts. From here, add skills, schedules, and more agents as you need them.