ACP Gateway

Your agents, on your computers — available from Telegram, CLI and MCP.

ACP Gateway connects a central dispatcher to agents running on your PCs. Choose an agent and a dialogue, send a task, review approval requests and receive the answer without opening a remote desktop.

Install · Documentation · Roadmap

How it works

flowchart LR
    Telegram --> Dispatcher[ACP Gateway dispatcher]
    CLI --> Dispatcher
    MCP --> Dispatcher
    Dispatcher <--> Home[Home PC · connector + agent]
    Dispatcher <--> Work[Work PC · connector + agent]

Connectors initiate the connection to the dispatcher. The agents execute tasks on their own computers; the dispatcher routes messages, results and approvals. Hermes Desktop and Goose integrations are described in the documentation.

What you can do

• Work with agents on multiple PCs through one Telegram bot.
• Create and switch dialogues, retrieve saved answers and handle approvals.
• Choose available models and execution modes when supported by the agent.
• Use the CLI or MCP interface alongside Telegram.
• Install the same package as a dispatcher or connector, with separate setup sections.

Install

Install uv, then:

uv tool install --python 3.12 "acp-gateway==0.2.1"
uv tool update-shell
acpgw setup

The current release is 0.2.1: one dispatcher, outgoing connectors from your PCs, Telegram dashboards and approvals, managed updates and an optional independent companion for updates from Telegram. See project status and the 0.2.1 upgrade instructions.

Follow the Ubuntu dispatcher + Windows/Hermes guide (Russian) for enrollment, connection, Telegram and autostart. For an existing installation, use the update and recovery guide.

To run the dispatcher in Docker on your VPS — behind the reverse proxy you already have, with your own nginx, or by moving a native dispatcher into Docker without re-enrolling computers — see the Docker dispatcher guide (Russian).

Explore

License

MIT