telegram-opencode-bridge-bot 0.1.2__tar.gz → 0.1.3__tar.gz

{telegram_opencode_bridge_bot-0.1.2 → telegram_opencode_bridge_bot-0.1.3}/.env.example

@@ -1,17 +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 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=opencode/deepseek-v4-flash-free
+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.2 → telegram_opencode_bridge_bot-0.1.3}/MANIFEST.in

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

{telegram_opencode_bridge_bot-0.1.2/telegram_opencode_bridge_bot.egg-info → telegram_opencode_bridge_bot-0.1.3}/PKG-INFO

@@ -1,146 +1,151 @@
-Metadata-Version: 2.4
-Name: telegram-opencode-bridge-bot
-Version: 0.1.2
-Summary: A Telegram bot that bridges messages directly to OpenCode — an AI coding agent running on your machine
-Author-email: MaheshNagabhairava <maheshnagabhirava12345@gmail.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. Run the Bot
-
-```bash
-python bot.py
-python bot.py --env (use --env flag if u want to re-configure later anytime)
-```
-> **💡 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.
-
-### 3. 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
-```
-
+Metadata-Version: 2.4
+Name: telegram-opencode-bridge-bot
+Version: 0.1.3
+Summary: A Telegram bot that bridges messages directly to OpenCode — an AI coding agent running on your machine
+Author-email: MaheshNagabhairava <maheshnagabhirava12345@gmail.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 Installation:
+```bash
+pip install telegram-opencode-bridge-bot==0.1.2
+telegram-opencode-bot
+telegram-opencode-bot --env (use --env flag if u want to re-configure later anytime)
+```
+### Manuall Installation:
+### 1. Clone & Install
+
+```bash
+cd telegram-opencode-bot
+pip install -r requirements.txt
+```
+
+### 2. Run the Bot
+
+```bash
+python bot.py
+python bot.py --env (use --env flag if u want to re-configure later anytime)
+```
+> **💡 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.
+
+### 3. 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.2 → telegram_opencode_bridge_bot-0.1.3}/README.md

@@ -26,8 +26,13 @@ A lightweight Python bot that bridges your Telegram messages directly to [OpenCo
 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
-
+### Quick Installation:
+```bash
+pip install telegram-opencode-bridge-bot==0.1.2
+telegram-opencode-bot
+telegram-opencode-bot --env (use --env flag if u want to re-configure later anytime)
+```
+### Manuall Installation:
 ### 1. Clone & Install
 
 ```bash