telegram-opencode-bridge-bot 0.1.0__tar.gz

telegram_opencode_bridge_bot-0.1.0/.env.example

@@ -0,0 +1,17 @@
+# Telegram Bot Configuration
+TELEGRAM_BOT_TOKEN=your_bot_token_from_botfather
+AUTHORIZED_USERS=123456789,987654321
+
+# OpenCode Configuration
+OPENCODE_SERVER_URL=http://localhost:4096
+OPENCODE_SERVER_USERNAME=
+OPENCODE_SERVER_PASSWORD=
+OPENCODE_MODEL=anthropic/claude-sonnet-4
+OPENCODE_WORK_DIR=.
+
+# Limits
+MAX_MESSAGE_LENGTH=4000
+RESPONSE_TIMEOUT=0  # Set to 0 to disable request timeouts entirely
+
+# Database
+DB_PATH=sessions.db

telegram_opencode_bridge_bot-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include .env.example
+include README.md
+include requirements.txt

telegram_opencode_bridge_bot-0.1.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: telegram-opencode-bridge-bot
+Version: 0.1.0
+Summary: A Telegram bot that bridges messages directly to OpenCode — an AI coding agent running on your machine
+Author-email: MaheshNagabhairava <your@email.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/MaheshNagabhairava/telegram-opencode-bridge-bot
+Keywords: telegram,bot,opencode,ai,coding,bridge
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: python-telegram-bot[ext]>=21.0
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: aiosqlite>=0.19.0
+
+# 🤖 Telegram → OpenCode Bridge Bot
+
+A lightweight Python bot that bridges your Telegram messages directly to [OpenCode](https://opencode.ai) — an AI coding agent running on your machine. Think of it as having Claude/GPT-powered coding assistance right in your pocket via Telegram.
+
+## ✨ Features
+
+- **Direct OpenCode integration** — routes your messages to OpenCode's HTTP API
+- **Persistent sessions** — conversations maintain context across messages
+- **Session management** — create, switch, list, and share sessions
+- **Model switching** — change AI models on the fly (`/model`)
+- **Plan/Build modes** — toggle between read-only analysis and full execution
+- **Smart formatting** — code blocks with syntax highlighting in Telegram
+- **Auto message splitting** — handles responses longer than Telegram's 4096 char limit
+- **Security** — whitelist-based access control + rate limiting
+- **Workspace Switching** — Switching from one workspace to another
+
+## 📋 Prerequisites
+
+1. **Python 3.10+**
+2. **OpenCode CLI** — install via:
+   ```bash
+   npm install -g opencode-ai
+   # or
+   curl -fsSL https://opencode.ai/install | bash
+   ```
+3. **Telegram Bot Token** — get one from [@BotFather](https://t.me/BotFather)
+4. **Your Telegram User ID** — send `/id` to the bot after setup, or use [@userinfobot](https://t.me/userinfobot)
+
+## 🚀 Quick Start
+
+### 1. Clone & Install
+
+```bash
+cd telegram-opencode-bot
+pip install -r requirements.txt
+```
+
+### 2. Start OpenCode Server
+
+In a separate terminal:
+
+```bash
+opencode serve --port 4096 --hostname 127.0.0.1
+```
+
+This starts the OpenCode HTTP API on `localhost:4096`.
+
+### 3. Run the Bot
+
+```bash
+python bot.py
+python bot.py --env (if u want to setup ur configuration later)
+```
+> **💡 Tip:** Don't know your Telegram user ID? Start the bot with `AUTHORIZED_USERS=0` temporarily, send `/id` to the bot, then update the `.env` with your real ID.
+
+### 4. Chat!
+
+Open Telegram, find your bot, and start asking! 🎉
+
+## 📱 Commands
+
+| Command | Description |
+|---------|-------------|
+| `/start` | Welcome message & connection check |
+| `/help` | Show all commands |
+| `/new` | Start a fresh conversation |
+| `/sessions` | List your recent sessions |
+| `/switch <id>` | Switch to a different session |
+| `/model <name>` | Change AI model(ex: /model opencode/deepseek-v4-flash-free) |
+| `/mode <plan\|build>` | Toggle plan/build mode |
+| `/share` | Share current session (public URL) |
+| `/status` | Check connection & session details |
+| `/id` | Show your Telegram user ID |
+| `/stop` | Abort active model processing |
+| `/models` | List all available models |
+| `/project` | To view the current workspace, sub folder workspaces and to change the workspace (ex: /project 2)|
+| `/project depth <1to5>` | Depth level recursive check for subfolders (ex: if u give depth 2, only 2 sub folders it will show from root) |
+| `/enable` | To enable the streaming |
+| `/disable` | To disable the streaming |
+
+## 🏗️ Architecture
+
+```
+Telegram User
+    │
+    ▼
+Telegram Bot (Python)
+    │
+    ├──► OpenCode HTTP API (localhost:4096)  ← primary
+            │
+            ├──► LLM Provider (Claude/GPT/Gemini)
+            └──► Local Filesystem & Shell
+```
+
+## ⚙️ Configuration
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `TELEGRAM_BOT_TOKEN` | Bot token from @BotFather | **Required** |
+| `AUTHORIZED_USERS` | Comma-separated Telegram user IDs | **Required** |
+| `OPENCODE_SERVER_URL` | OpenCode HTTP API URL | `http://localhost:4096` |
+| `OPENCODE_SERVER_USERNAME` | OpenCode auth username | *(empty)* |
+| `OPENCODE_SERVER_PASSWORD` | OpenCode auth password | *(empty)* |
+| `OPENCODE_MODEL` | Default AI model | `anthropic/claude-sonnet-4` |
+| `OPENCODE_WORK_DIR` | Working directory for OpenCode | `.` |
+| `MAX_MESSAGE_LENGTH` | Max Telegram message length | `4000` |
+| `RESPONSE_TIMEOUT` | Max wait for response (seconds) | `0` |
+| `DB_PATH` | SQLite database path | `sessions.db` |
+
+## 🔒 Security
+
+- **User whitelist** — only Telegram user IDs in `AUTHORIZED_USERS` can use the bot
+- **Rate limiting** — 20 requests per minute per user (configurable)
+- **No public exposure** — designed to run on your local machine
+
+> ⚠️ **Warning:** This bot executes AI-driven code on your machine. Only authorize trusted users.
+
+## 📁 Project Structure
+
+```
+telegram-opencode-bot/
+├── bot.py                  # Main entry point
+├── config.py               # Environment configuration
+├── handlers/
+│   ├── commands.py         # Slash command handlers
+│   └── messages.py         # Text message → OpenCode bridge
+├── opencode/
+│   ├── client.py           # OpenCode HTTP API client
+│   
+├── sessions/
+│   └── manager.py          # Per-user session tracking (SQLite)
+├── utils/
+│   ├── formatting.py       # Telegram message formatting
+│   └── security.py         # Auth, rate limiting, sanitization
+├── .env.example            # Environment template
+├── requirements.txt        # Python dependencies
+└── README.md               # This file
+```
+

telegram_opencode_bridge_bot-0.1.0/README.md

@@ -0,0 +1,139 @@
+# 🤖 Telegram → OpenCode Bridge Bot
+
+A lightweight Python bot that bridges your Telegram messages directly to [OpenCode](https://opencode.ai) — an AI coding agent running on your machine. Think of it as having Claude/GPT-powered coding assistance right in your pocket via Telegram.
+
+## ✨ Features
+
+- **Direct OpenCode integration** — routes your messages to OpenCode's HTTP API
+- **Persistent sessions** — conversations maintain context across messages
+- **Session management** — create, switch, list, and share sessions
+- **Model switching** — change AI models on the fly (`/model`)
+- **Plan/Build modes** — toggle between read-only analysis and full execution
+- **Smart formatting** — code blocks with syntax highlighting in Telegram
+- **Auto message splitting** — handles responses longer than Telegram's 4096 char limit
+- **Security** — whitelist-based access control + rate limiting
+- **Workspace Switching** — Switching from one workspace to another
+
+## 📋 Prerequisites
+
+1. **Python 3.10+**
+2. **OpenCode CLI** — install via:
+   ```bash
+   npm install -g opencode-ai
+   # or
+   curl -fsSL https://opencode.ai/install | bash
+   ```
+3. **Telegram Bot Token** — get one from [@BotFather](https://t.me/BotFather)
+4. **Your Telegram User ID** — send `/id` to the bot after setup, or use [@userinfobot](https://t.me/userinfobot)
+
+## 🚀 Quick Start
+
+### 1. Clone & Install
+
+```bash
+cd telegram-opencode-bot
+pip install -r requirements.txt
+```
+
+### 2. Start OpenCode Server
+
+In a separate terminal:
+
+```bash
+opencode serve --port 4096 --hostname 127.0.0.1
+```
+
+This starts the OpenCode HTTP API on `localhost:4096`.
+
+### 3. Run the Bot
+
+```bash
+python bot.py
+python bot.py --env (if u want to setup ur configuration later)
+```
+> **💡 Tip:** Don't know your Telegram user ID? Start the bot with `AUTHORIZED_USERS=0` temporarily, send `/id` to the bot, then update the `.env` with your real ID.
+
+### 4. Chat!
+
+Open Telegram, find your bot, and start asking! 🎉
+
+## 📱 Commands
+
+| Command | Description |
+|---------|-------------|
+| `/start` | Welcome message & connection check |
+| `/help` | Show all commands |
+| `/new` | Start a fresh conversation |
+| `/sessions` | List your recent sessions |
+| `/switch <id>` | Switch to a different session |
+| `/model <name>` | Change AI model(ex: /model opencode/deepseek-v4-flash-free) |
+| `/mode <plan\|build>` | Toggle plan/build mode |
+| `/share` | Share current session (public URL) |
+| `/status` | Check connection & session details |
+| `/id` | Show your Telegram user ID |
+| `/stop` | Abort active model processing |
+| `/models` | List all available models |
+| `/project` | To view the current workspace, sub folder workspaces and to change the workspace (ex: /project 2)|
+| `/project depth <1to5>` | Depth level recursive check for subfolders (ex: if u give depth 2, only 2 sub folders it will show from root) |
+| `/enable` | To enable the streaming |
+| `/disable` | To disable the streaming |
+
+## 🏗️ Architecture
+
+```
+Telegram User
+    │
+    ▼
+Telegram Bot (Python)
+    │
+    ├──► OpenCode HTTP API (localhost:4096)  ← primary
+            │
+            ├──► LLM Provider (Claude/GPT/Gemini)
+            └──► Local Filesystem & Shell
+```
+
+## ⚙️ Configuration
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `TELEGRAM_BOT_TOKEN` | Bot token from @BotFather | **Required** |
+| `AUTHORIZED_USERS` | Comma-separated Telegram user IDs | **Required** |
+| `OPENCODE_SERVER_URL` | OpenCode HTTP API URL | `http://localhost:4096` |
+| `OPENCODE_SERVER_USERNAME` | OpenCode auth username | *(empty)* |
+| `OPENCODE_SERVER_PASSWORD` | OpenCode auth password | *(empty)* |
+| `OPENCODE_MODEL` | Default AI model | `anthropic/claude-sonnet-4` |
+| `OPENCODE_WORK_DIR` | Working directory for OpenCode | `.` |
+| `MAX_MESSAGE_LENGTH` | Max Telegram message length | `4000` |
+| `RESPONSE_TIMEOUT` | Max wait for response (seconds) | `0` |
+| `DB_PATH` | SQLite database path | `sessions.db` |
+
+## 🔒 Security
+
+- **User whitelist** — only Telegram user IDs in `AUTHORIZED_USERS` can use the bot
+- **Rate limiting** — 20 requests per minute per user (configurable)
+- **No public exposure** — designed to run on your local machine
+
+> ⚠️ **Warning:** This bot executes AI-driven code on your machine. Only authorize trusted users.
+
+## 📁 Project Structure
+
+```
+telegram-opencode-bot/
+├── bot.py                  # Main entry point
+├── config.py               # Environment configuration
+├── handlers/
+│   ├── commands.py         # Slash command handlers
+│   └── messages.py         # Text message → OpenCode bridge
+├── opencode/
+│   ├── client.py           # OpenCode HTTP API client
+│   
+├── sessions/
+│   └── manager.py          # Per-user session tracking (SQLite)
+├── utils/
+│   ├── formatting.py       # Telegram message formatting
+│   └── security.py         # Auth, rate limiting, sanitization
+├── .env.example            # Environment template
+├── requirements.txt        # Python dependencies
+└── README.md               # This file
+```
+

telegram_opencode_bridge_bot-0.1.0/handlers/__init__.py

@@ -0,0 +1 @@
+