Skip to content

xx025/openab

Repository files navigation

中文 · English

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

About

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

Resources

License

Stars

Watchers

Forks

Languages