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.0"
uv tool update-shell
acpgw setup

The current release is 0.2.0, the first stable release: one dispatcher, outgoing connectors from your PCs, Telegram dashboards and approvals, managed updates, and a Docker dispatcher for a VPS. See project status for what is still being accepted.

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