BotLane

Run a Grok-powered bot from Telegram.

Open-source bridge that connects a Grok (xAI) bot to Telegram and lets you drive it straight from chat — one-to-one, in groups, or with scheduled tasks. No server to babysit, no webhooks to configure.

Why it exists

People who run agent bots on X want to reach them from Telegram too — the same bot, the same memory, no extra setup. BotLane is that bridge:

• Dependency-free — the Python SDK and local bridge use only the standard library. No pip installs beyond talocode-botlane.
• 1:1 and group mode — private chats work out of the box; in groups the bot responds only to @mention, /commands, and replies.
• Session memory — per-chat conversation history persisted to disk.
• Secure by default — an allowlist gates who can talk to the bot so your credits don't get drained by strangers.
• Hosted path available — use the open tool locally, or run it on Talocode Cloud under /v1/botlane/* for managed power.

Part of Talocode: open tools people trust, hosted power behind them.

Install

pip install talocode-botlane

Node version (CLI, SDK, MCP server, HTTP API):

npm install -g @talocode/botlane

Quickstart

Talk to a hosted BotLane instance

from botlane import BotLaneClient

client = BotLaneClient()          # uses TALOCODE_API_KEY + TALOCODE_BASE_URL
print(client.health())
client.send(chat_id=123456789, text="Hello from the bot")
reply = client.chat("Summarize the last 3 messages")
print(reply)

Run a local bridge from Python

from botlane import BotLaneBridge

bridge = BotLaneBridge()          # uses TELEGRAM_BOT_TOKEN + XAI_API_KEY
bridge.run()                      # long-polls Telegram and replies with Grok

Auth / env

The Python SDK reads the same environment the hosted path uses:

API surface

Hosted routes (Talocode Cloud)

Auth:

Authorization: Bearer $TALOCODE_API_KEY
# or
X-Api-Key: $TALOCODE_API_KEY

SDK methods

CLI

botlane check                          # validate config, print bot identity
botlane run --model grok-3-mini        # start the local bridge
botlane send 123456789 "Hello"         # one-off message from the bot
botlane chat "What is 2+2?"            # one-off completion via hosted API
botlane health                         # check a hosted instance

MCP server

The npm package ships a dependency-free Model Context Protocol server (botlane-mcp) so agent runtimes (Cursor, Claude Code, OpenCode, Codra) can drive the bot directly. Tools: botlane_check, botlane_send, botlane_history, botlane_reset, botlane_chat.

Develop

git clone https://github.com/talocode/botlane
cd botlane/python
pip install -e .
python -m botlane.cli check

Related packages

Talocode ecosystem

More: github.com/talocode · talocode.site · docs.talocode.site

Links

• GitHub: https://github.com/talocode/botlane
• npm: https://www.npmjs.com/package/@talocode/botlane
• PyPI: https://pypi.org/project/talocode-botlane
• Docs: https://docs.talocode.site
• API base: https://api.talocode.site

License

MIT © Talocode