Metadata-Version: 2.5
Name: acp-gateway
Version: 0.2.0
Summary: Local gateway that routes messages from external channels (Hermes, Telegram, ...) to ACP agents
Project-URL: Homepage, https://github.com/Lujker/acp-gateway
Project-URL: Repository, https://github.com/Lujker/acp-gateway
Project-URL: Issues, https://github.com/Lujker/acp-gateway/issues
Author: Lujker
License-Expression: MIT
License-File: LICENSE
Keywords: acp,agent-client-protocol,gateway,goose,hermes,mcp,telegram
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development
Requires-Python: >=3.12
Requires-Dist: agent-client-protocol[http]>=0.12
Requires-Dist: aiogram<4,>=3.22
Requires-Dist: colorama>=0.4.6; sys_platform == 'win32'
Requires-Dist: fastapi>=0.115
Requires-Dist: filelock>=3.16
Requires-Dist: httpx>=0.28
Requires-Dist: markdown-it-py<5,>=3
Requires-Dist: mcp<2,>=1.20
Requires-Dist: packaging>=24
Requires-Dist: platformdirs>=4.3
Requires-Dist: pydantic-settings[yaml]>=2.8
Requires-Dist: pydantic>=2.10
Requires-Dist: python-dotenv>=1.0
Requires-Dist: structlog>=25.1
Requires-Dist: uvicorn>=0.34
Requires-Dist: websockets>=15
Description-Content-Type: text/markdown

# 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.

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Python 3.12+](https://img.shields.io/badge/Python-3.12%2B-blue.svg)](pyproject.toml)
[![PyPI](https://img.shields.io/pypi/v/acp-gateway?include_prereleases)](https://pypi.org/project/acp-gateway/)

[Install](docs/setup/self-install-pypi.ru.md) · [Documentation](docs/README.md) · [Roadmap](road-map.md)

## How it works

```mermaid
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](https://docs.astral.sh/uv/getting-started/installation/), then:

```sh
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](docs/project-status.md) for what
is still being accepted.

Follow the [Ubuntu dispatcher + Windows/Hermes guide (Russian)](docs/setup/self-install-pypi.ru.md)
for enrollment, connection, Telegram and autostart. For an existing installation,
use the [update and recovery guide](docs/setup/maintenance.md).

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)](docs/setup/vps-docker.ru.md).

## Explore

| I want to… | Start here |
| --- | --- |
| Set up Telegram | [Bot setup and commands](docs/setup/telegram.md) |
| Run the dispatcher in Docker on a VPS | [Docker dispatcher (Russian)](docs/setup/vps-docker.ru.md) |
| Understand support and limitations | [Project status](docs/project-status.md) |
| Configure a different deployment | [Documentation index](docs/README.md) |
| Develop or build from source | [Development guide](docs/development.md) |
| See what comes next | [Roadmap and queue](road-map.md) |

## License

[MIT](LICENSE)
