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

The current documented release candidate is 0.2.0rc7. Source development is 0.2.0rc8.dev0, which includes review fixes and new Telegram dashboards and has not been released. This project is still in release-candidate acceptance.

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

Explore

License

MIT