Skip to main content

Open Agent Bridge — connect agent backends (CLIs, APIs) to chat platforms (Telegram, …).

Project description

OpenAB

OpenAB

Open Agent Bridge — Connect AI agents to chat platforms. One config, one bridge. Currently implemented: Cursor, Codex. Gemini, Claude, OpenClaw not yet implemented.

中文 · Configuration & usage


What it does

OpenAB forwards messages from chat platforms (or HTTP API) to an agent backend you choose and sends the reply back. One config, one bridge.

Agents Chats / API
Cursor, Codex (implemented)
Gemini, Claude, OpenClaw not yet implemented
Telegram, Discord, OpenAI-compatible HTTP API (openab run serve), more planned

Quick start

1. Install (Python 3.10+)

pip install openab
# or: uv tool install openab
# or from repo: uv pip install -e .

2. Run and follow the prompts

openab run

You’ll choose serve (API), telegram, or discord, enter bot token and allowlist when asked; choices are saved to ~/.config/openab/config.yaml. Then open your bot in the app and chat, or use the API at http://127.0.0.1:8000/v1 with the printed key. Use /resume or !resume in chat to switch sessions.

  • Tokens: Telegram → @BotFather /newbot; Discord → Developer Portal → Bot → Reset Token.
  • Unauthorized? Send /whoami or !whoami to get your ID, then openab config set telegram.allowed_user_ids "ID" (or send the API key to the bot to self-add).

Full options: Configuration & usage.


Docs


License

MIT — LICENSE

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openab-0.1.8.tar.gz (37.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openab-0.1.8-py3-none-any.whl (48.4 kB view details)

Uploaded Python 3

File details

Details for the file openab-0.1.8.tar.gz.

File metadata

  • Download URL: openab-0.1.8.tar.gz
  • Upload date:
  • Size: 37.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for openab-0.1.8.tar.gz
Algorithm Hash digest
SHA256 c4c63cbca5cf0171577fd99f7b25cabdb58b7dbbe4b83425f724adde6f5ec114
MD5 31abf011869c012ca09e5e3c5f0b6bc0
BLAKE2b-256 03077fdc94fffbf6fc2636424b3a8a16045f1f1439fa5b212776e072ec7b0fc0

See more details on using hashes here.

Provenance

The following attestation bundles were made for openab-0.1.8.tar.gz:

Publisher: publish.yaml on xx025/openab

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file openab-0.1.8-py3-none-any.whl.

File metadata

  • Download URL: openab-0.1.8-py3-none-any.whl
  • Upload date:
  • Size: 48.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for openab-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 28a93cf2391053b2e4b042348a8a33e3c5043f437d6a10d1f10f5619eb627511
MD5 b0bc4030dda5a563551789eaf2b2a7cf
BLAKE2b-256 f84e1eda0c3ab321afdf8a51a3e2c61001fbefa572a517b49ddd4c4173e29e7e

See more details on using hashes here.

Provenance

The following attestation bundles were made for openab-0.1.8-py3-none-any.whl:

Publisher: publish.yaml on xx025/openab

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page