samarthya-bot 1.1.4 → 2.0.0

package/README.md

@@ -1,183 +1,359 @@
 <div align="center">
-  <img src="https://raw.githubusercontent.com/mebishnusahu0595/SamarthyaBot/main/backend/public/logo.png" width="200" height="200" alt="SamarthyaBot Logo" />
-  <h1>स SamarthyaBot — Your Local Agentic OS</h1>
-  
-  <p>
-    <strong>Privacy-First • Multi-Agent • Autonomous • Made in India</strong>
-  </p>
+  <img src="https://raw.githubusercontent.com/mebishnusahu0595/SamarthyaBot/main/backend/public/logo.png" width="180" height="180" alt="SamarthyaBot Logo">
 
-  <p>
-    <a href="https://www.npmjs.com/package/samarthya-bot"><img src="https://img.shields.io/npm/v/samarthya-bot?color=FB8C00&style=for-the-badge" alt="NPM Version" /></a>
-    <a href="https://github.com/mebishnusahu0595/SamarthyaBot"><img src="https://img.shields.io/github/stars/mebishnusahu0595/SamarthyaBot?style=for-the-badge&color=FFD600" alt="GitHub Stars" /></a>
-    <img src="https://img.shields.io/npm/l/samarthya-bot?style=for-the-badge&color=2196F3" alt="License" />
-    <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge" alt="PRs Welcome" />
-  </p>
+  <h1>🇮🇳 SamarthyaBot — Your Local Agentic OS</h1>
 
-  <p>
-    SamarthyaBot is a personal AI assistant you run on your own devices. It answers you on the channels you already use (WhatsApp, Telegram), handles absolute local privacy, and executes multi-step autonomous plans. The Gateway is your control plane — the product is the assistant.
-  </p>
+  <h3>Privacy-First · Multi-Agent · Autonomous · Made in India 🇮🇳</h3>
 
   <p>
-    <a href="#-quick-start">Quick Start</a> •
-    <a href="#-key-highlights">Highlights</a> •
-    <a href="#-cli-commands">CLI</a> •
-    <a href="#-developing-plugins">Plugins</a> •
-    <a href="#-security">Security</a>
+    <img src="https://img.shields.io/badge/Node.js-20_LTS-339933?style=flat&logo=nodedotjs&logoColor=white" alt="Node.js">
+    <img src="https://img.shields.io/badge/Go-1.22+-00ADD8?style=flat&logo=go&logoColor=white" alt="Go Worker">
+    <img src="https://img.shields.io/badge/React-19-61DAFB?style=flat&logo=react&logoColor=black" alt="React">
+    <img src="https://img.shields.io/badge/MongoDB-Local-47A248?style=flat&logo=mongodb&logoColor=white" alt="MongoDB">
+    <img src="https://img.shields.io/badge/license-MIT-138808?style=flat" alt="License">
+    <br>
+    <a href="https://www.npmjs.com/package/samarthya-bot"><img src="https://img.shields.io/npm/v/samarthya-bot?color=FF9933&style=flat&logo=npm&logoColor=white&label=npm" alt="NPM"></a>
+    <a href="https://github.com/mebishnusahu0595/SamarthyaBot"><img src="https://img.shields.io/github/stars/mebishnusahu0595/SamarthyaBot?style=flat&color=FFD600&logo=github" alt="Stars"></a>
+    <img src="https://img.shields.io/badge/PRs-welcome-FF9933?style=flat" alt="PRs Welcome">
   </p>
 </div>
 
-<hr/>
+---
+
+🤖 SamarthyaBot is a **privacy-first personal AI Operating System** that runs entirely on YOUR devices. It's not just a chatbot — it's a **Full RPA (Robotic Process Automation) Agent** that writes code, commits to GitHub, deploys to servers, controls browsers, sends real emails, and handles Indian workflows (GST, UPI, IRCTC) — all from a single Telegram message or a beautiful Web Dashboard.
 
-## 🚀 Quick Start
+⚡ Powered by a **Go Micro-Worker** for live terminal streaming, **Puppeteer** for real browser control, and multi-provider AI (Gemini, Claude, Ollama, DeepSeek, OpenRouter) — SamarthyaBot is the most feature-rich self-hosted AI agent built for Indian developers.
 
-SamarthyaBot is built for developers. The best way to start is the **CLI Wizard**.
+> [!CAUTION]
+> **🚨 SECURITY NOTICE**
+>
+> * SamarthyaBot runs **locally on YOUR machine**. Your data never leaves your device.
+> * All sensitive data (API keys, memories) is encrypted via **AES-256-CBC**.
+> * Dangerous commands (`rm -rf`, `mkfs`, `format`) are **blocked by regex blacklists**.
+> * SamarthyaBot is in active development — use with caution in production.
 
-### 📦 Install (Global)
+---
+
+## ✨ Features
+
+| Feature | Description | Status |
+| :--- | :--- | :---: |
+| 🤖 **Full RPA Engine** | Writes code, commits to GitHub, deploys to VPS autonomously | ✅ Live |
+| ⚡ **Go Micro-Worker** | Live terminal streaming — `npm build`, `git push` without freezing Node.js | ✅ Live |
+| 🌍 **SSH Deployments** | Deploy to remote servers via password or PEM key from a chat prompt | ✅ Live |
+| 🕸️ **Browser Controller** | Puppeteer-based real DOM interaction — scrape, click, navigate | ✅ Live |
+| 🛡️ **Zero-Harm Blacklists** | OS regex block-layer protects against dangerous commands | ✅ Live |
+| 🧠 **Autonomous Planner** | ReAct engine breaks complex requests into discrete steps | ✅ Live |
+| 🔐 **Encrypted Memory** | AES-256-CBC encrypted local memory in MongoDB | ✅ Live |
+| 🇮🇳 **Indian Localization** | GST calculator, UPI links, IRCTC, Hindi/Hinglish fluency | ✅ Live |
+| 📧 **Real Email** | Send actual emails via Nodemailer SMTP — not a simulation | ✅ Live |
+| 📁 **File Manager** | Read, write, edit, append, list files in your workspace | ✅ Live |
+| 👁️ **Screen Vision** | Gemini Vision analyzes screenshots for UI/UX understanding | ✅ Live |
+| 📱 **Telegram Bot** | Full two-way Telegram integration with webhook + tunnel | ✅ Live |
+| 🌐 **Web Dashboard** | Beautiful React UI to manage agent, view logs, chat live | ✅ Live |
+| 🔌 **Plugin System** | Drop a `.js` file → new AI skill. Zero restart needed | ✅ Live |
+| 🤖 **Multi-LLM** | Gemini, Claude, DeepSeek, Qwen, OpenRouter, Ollama | ✅ Live |
+| 🎙️ **Voice (Whisper)** | Groq/Whisper transcription for Telegram voice notes | ✅ Live |
+| 💬 **Discord Bot** | Full Discord integration with mention-only mode | ✅ Live |
+| 🔒 **Workspace Sandbox** | File ops restricted to workspace, configurable security | ✅ Live |
+| 💓 **Heartbeat Tasks** | Periodic autonomous tasks from `HEARTBEAT.md` | ✅ Live |
+| 🚀 **Sub-Agent Spawn** | Non-blocking background agents for long-running tasks | ✅ Live |
+
+## 🏆 Comparison
+
+|                        | OpenClaw       | PicoClaw             | **SamarthyaBot** 🇮🇳               |
+| ---------------------- | -------------- | -------------------- | ----------------------------------- |
+| **Language**           | TypeScript     | Go                   | **Node.js + Go + React**            |
+| **Browser Control**    | ❌ None        | ❌ Search APIs only  | **✅ Real Puppeteer DOM**           |
+| **Web Dashboard**      | ✅ Yes         | ❌ CLI only          | **✅ Beautiful React UI**           |
+| **Live Terminal**      | ❌ No          | ❌ Spawn (async)     | **✅ Go Worker Streaming**          |
+| **Indian Workflows**   | ❌ No          | ❌ No                | **✅ GST/UPI/IRCTC/Hindi**          |
+| **Encrypted Memory**   | ❌ Plain text  | ❌ Markdown files    | **✅ AES-256-CBC + MongoDB**        |
+| **Voice Transcription**| ❌ No          | ✅ Groq Whisper      | **✅ Groq Whisper**                 |
+| **Chat Channels**      | 2              | 7                    | **Telegram + Discord + Web**        |
+| **SSH Deploy**         | ❌ No          | ❌ No                | **✅ Password + PEM Key**           |
+| **Plugin System**      | ❌ No          | Skills folder        | **✅ Drop-in JS plugins**           |
+| **Startup RAM**        | >1GB           | <10MB                | ~100MB (Full-stack + DB)            |
+| **Install Complexity** | High           | Single binary        | `npm i -g samarthya-bot` ✨         |
 
-Runtime: **Node 20 LTS** (Officially Supported/Recommended) and **MongoDB** (Local).
+---
+
+## 🚀 Quick Start
+
+> [!TIP]
+> **Prerequisites:** [Node.js 20 LTS](https://nodejs.org/) · [MongoDB](https://www.mongodb.com/try/download/community) (local)
+> Get API keys: [Gemini](https://aistudio.google.com/api-keys) (Free) · [Ollama](https://ollama.com) (Free, Local)
+> Optional: [Telegram Bot Token](https://t.me/BotFather) · [Groq](https://console.groq.com) (Voice) · [OpenRouter](https://openrouter.ai/keys) (100+ models)
+
+### 📦 Install (One Command)
 
 ```bash
 npm install -g samarthya-bot
 
-# Start the interactive setup
+# Interactive setup wizard
 samarthya onboard
 
-# Launch the engine and dashboard (Terminal 1)
+# Launch the engine + dashboard (Terminal 1)
 samarthya gateway
 
-# Expose to internet & setup Telegram Webhook (Terminal 2)
+# Expose to internet & link Telegram (Terminal 2)
 samarthya tunnel
 ```
-*The wizard guides you through API keys (Gemini/Ollama, Telegram Bot Token) and system permissions.*
 
-### 🛠️ From Source (Development)
+That's it! 🎉 Open **http://localhost:5000** for the Dashboard.
 
-If you want to contribute or build custom features:
+### 🛠️ From Source (Development)
 
 ```bash
 git clone https://github.com/mebishnusahu0595/SamarthyaBot.git
 cd SamarthyaBot
 
-# Install dependencies
+# Install all dependencies
 npm install
 
-# Run the setup
+# Setup API keys interactively
 samarthya onboard
 
-# Start development loop
+# Start development server
 npm run dev
 ```
 
 ---
 
-## 🌟 Key Highlights
+## 💬 Chat Channels
 
-- 🤖 **Full RPA Engine (v1.1.3 God Mode):** Evolved from a chat assistant to a **Robotic Process Automation** agent. Writes code, commits to GitHub, and deploys to remote servers autonomously.
-- ⚡ **Go Micro-Worker Streaming:** Heavy CLI tasks (`npm build`, `git push`) are handled by a Golang backend that streams live terminal states back to the AI without freezing Node.js.
-- 🌍 **SSH Remote Deployments:** Native support for securely logging into remote VPS architectures (via Password or PEM keys) to deploy your Node/Python apps directly from a prompt.
-- 🕸️ **Browser DOM Controller:** Natively integrates `puppeteer-core`. Can connect to your local Chrome to navigate web pages, scrape UI, or create a new GitHub repository by interacting with real DOM selectors.
-- 🛡️ **Zero-Harm Blacklists:** Strict OS regex block-layer protects your computer from dangerous commands (`rm -rf`, `mkfs`), keeping autonomous loops perfectly safe.
-- 🧠 **Autonomous Planning**: Native ReAct engine breaks complex requests into discrete steps.
-- 🔐 **Encrypted Memory**: Every interaction is stored locally. Sensitive data like API keys are encrypted via **AES-256-CBC**.
-- 🇮🇳 **Indian Localization**: Specialized tools for **GST**, **IRCTC**, **UPI** links, and native **Hinglish/Hindi** fluency.
+Talk to SamarthyaBot on your favorite platform:
 
----
+| Channel | Setup | Status |
+| :--- | :--- | :---: |
+| **Telegram** | Easy — just a bot token + `samarthya tunnel` | ✅ Live |
+| **Discord** | Bot token + intents + invite URL | ✅ Live |
+| **Web Dashboard** | Built-in at `http://localhost:5000` | ✅ Live |
+| **WhatsApp** | Business API integration | 🔜 Coming |
+| **Slack** | Webhook + App | 📋 Planned |
 
-## 🛠️ CLI Commands
+<details>
+<summary><b>📱 Telegram Setup</b> (Recommended)</summary>
 
-| Command | Action |
-| :--- | :--- |
-| `samarthya onboard` | Start the installation & configuration wizard. |
-| `samarthya gateway` | Run the backend control plane and serve the Dashboard. |
-| `samarthya status` | Display the status of background jobs and the engine. |
-| `samarthya stop` | Gracefully shut down all background autonomous agents. |
-| `samarthya model` | Swap between LLM providers (e.g. `ollama`, `gemini`). |
-| `samarthya tunnel` | Expose gateway to internet. **(Must run in a separate terminal)** |
+**1. Create a bot**
+* Open Telegram → search `@BotFather`
+* Send `/newbot`, follow prompts
+* Copy the token
+
+**2. Configure** — Add to your `.env`:
+```bash
+TELEGRAM_BOT_TOKEN=YOUR_BOT_TOKEN
+```
+
+**3. Run**
+```bash
+# Terminal 1
+samarthya gateway
+
+# Terminal 2 (new terminal!)
+samarthya tunnel
+```
+
+The tunnel automatically sets the webhook URL. You're live! 🚀
+
+</details>
+
+<details>
+<summary><b>💬 Discord Setup</b></summary>
+
+**1. Create a bot**
+* Go to https://discord.com/developers/applications
+* Create Application → Bot → Copy Token
+
+**2. Enable Intents** — In Bot settings:
+* ✅ MESSAGE CONTENT INTENT
+* ✅ SERVER MEMBERS INTENT (optional)
+
+**3. Configure** — Add to your `.env`:
+```bash
+DISCORD_BOT_TOKEN=YOUR_BOT_TOKEN
+DISCORD_ALLOW_FROM=YOUR_USER_ID
+```
+
+**4. Invite the bot**
+* OAuth2 → URL Generator → Scope: `bot`
+* Permissions: `Send Messages`, `Read Message History`
+* Open the generated URL → add to your server
+
+**5. Run**
+```bash
+samarthya gateway
+```
+
+</details>
 
 ---
 
-## ⚙️ Environment Variables
+## ⚙️ Configuration
 
-If you are running from source or manual setup, create a `.env` file in the `backend/` directory.
+All configuration is in `backend/.env`:
 
 ```bash
-# Required
-GEMINI_API_KEY=your_gemini_api_key_here
+# ═══════════════ REQUIRED ═══════════════
+GEMINI_API_KEY=your_gemini_api_key
 MEMORY_ENCRYPTION_KEY=your_32_char_secret_key
 
-# Optional (For Remote Access)
-TELEGRAM_BOT_TOKEN=your_telegram_bot_api_key
+# ═══════════════ AI PROVIDERS ═══════════════
+ACTIVE_PROVIDER=gemini          # gemini | ollama | anthropic | deepseek | openrouter | qwen
+ACTIVE_MODEL=gemini-2.5-flash
 
-# Optional
+# Provider API Keys (set the one you use)
+ANTHROPIC_API_KEY=
+DEEPSEEK_API_KEY=
+OPENROUTER_API_KEY=
+QWEN_API_KEY=
+
+# Ollama (local, free, offline)
+USE_OLLAMA=false
+
+# ═══════════════ CHANNELS ═══════════════
+TELEGRAM_BOT_TOKEN=your_telegram_token
+DISCORD_BOT_TOKEN=your_discord_token
+
+# ═══════════════ VOICE ═══════════════
+GROQ_API_KEY=your_groq_key      # For Whisper voice transcription
+
+# ═══════════════ SECURITY ═══════════════
+RESTRICT_TO_WORKSPACE=true       # Sandbox all file/exec operations
+HEARTBEAT_INTERVAL=30            # Minutes between periodic tasks
+
+# ═══════════════ DATABASE ═══════════════
 MONGO_URI=mongodb://localhost:27017/samarthya
 PORT=5000
-USE_OLLAMA=false
-ACTIVE_PROVIDER=gemini # or ollama
 ```
 
-### 📱 Telegram Integration
-To connect SamarthyaBot to Telegram:
-1. Get a bot token from [@BotFather](https://t.me/BotFather).
-2. The `samarthya onboard` wizard will automatically ask for this token.
-3. Run `samarthya gateway` in your **first terminal**.
-4. Run `samarthya tunnel` in a **new, separate terminal**.
-5. Samarthya will automatically create a secure tunnel and link your bot!
+---
+
+## 🛠️ CLI Commands
+
+| Command | Action |
+| :--- | :--- |
+| `samarthya onboard` | Interactive setup wizard — API keys, permissions, everything |
+| `samarthya gateway` | Start the backend engine + serve the Dashboard |
+| `samarthya tunnel` | Expose to internet & auto-link Telegram webhook |
+| `samarthya status` | Show status of background jobs and the engine |
+| `samarthya stop` | Gracefully kill all autonomous background agents |
+| `samarthya model` | Swap LLM provider (gemini, ollama, claude, deepseek...) |
 
 ---
 
 ## 🔌 Developing Plugins
 
-Giving your AI a new Superpower is simple. Create a `.js` file in your plugins directory:
+Give your AI new superpowers — just drop a `.js` file:
 
 ```javascript
-// ~/SamarthyaBot_Files/plugins/hello.js
+// ~/SamarthyaBot_Files/plugins/weather.js
 module.exports = {
-    name: 'greet',
-    description: 'Greets the user in a friendly way',
+    name: 'get_weather',
+    description: 'Gets current weather for a city',
     parameters: {
-        name: { type: 'string', required: true }
+        city: { type: 'string', required: true }
     },
     execute: async (args) => {
-        return { success: true, result: `Namaste ${args.name}! Main SamarthyaBot hoon.` };
+        const res = await fetch(`https://wttr.in/${args.city}?format=j1`);
+        const data = await res.json();
+        return {
+            success: true,
+            result: `${args.city}: ${data.current_condition[0].temp_C}°C, ${data.current_condition[0].weatherDesc[0].value}`
+        };
     }
 };
 ```
-Restart the gateway and the agent can now "greet" anyone autonomously.
+
+Restart the gateway — the agent can now check weather autonomously! 🌦️
 
 ---
 
-## 🔐 Security & Privacy
+## 💓 Heartbeat (Periodic Tasks)
+
+Create `~/SamarthyaBot_Files/HEARTBEAT.md` to schedule autonomous tasks:
+
+```markdown
+# Periodic Tasks
+
+- Check my email for important messages
+- Search web for latest AI news and summarize
+- Remind me about today's calendar events
+```
+
+SamarthyaBot reads this file every 30 minutes (configurable) and executes each task using available tools. Results are sent via your active channel (Telegram/Discord/Dashboard).
 
-OpenClaw connecting to your real-world data requires trust. SamarthyaBot is **Local-First**:
+---
 
-1. **Local Control Plane**: The gateway runs on YOUR machine.
-2. **Offline-Ready**: Support for **Ollama** ensures 0% data leakage to the cloud.
-3. **Emergency Kill Switch**: Stop all background tasks instantly from the Dashboard.
-4. **Sandboxed Tools**: (In Progress) Capability to run tool executions in Docker environments.
+## 🔒 Security & Privacy
+
+| Feature | Description |
+| :--- | :--- |
+| **🏠 Local Control Plane** | Gateway runs on YOUR machine — zero cloud dependency |
+| **🔐 AES-256-CBC Encryption** | All memories and API keys encrypted at rest |
+| **🛡️ Command Blacklists** | `rm -rf`, `mkfs`, `format`, `dd if=` — all blocked |
+| **📁 Workspace Sandbox** | File/exec operations restricted to workspace folder |
+| **🔌 Ollama Offline Mode** | 100% offline AI — zero data leakage |
+| **🚨 Emergency Kill Switch** | `samarthya stop` — instant shutdown from CLI or Dashboard |
 
 ---
 
 ## 🏗️ Architecture
 
-```text
- WhatsApp / Telegram / WebUI / CLI Surface
-               │
-               ▼
-┌─────────────────────────────────┐
-│        Samarthya Gateway        │
-│      (The Control Plane)        │
-│      http://localhost:5000      │
-└──────────────┬──────────────────┘
-               │
-               ├─ Planner Engine (Multi-Step Logic)
-               ├─ Skill Registry (Plugins)
-               ├─ Background CRON (Autonomous Loops)
-               └─ Encrypted Memory Vault
+```
+  Telegram / Discord / WebUI / CLI
+                │
+                ▼
+  ┌──────────────────────────────────────────┐
+  │         SamarthyaBot Gateway             │
+  │        (The Control Plane)               │
+  │        http://localhost:5000             │
+  ├──────────────────────────────────────────┤
+  │                                          │
+  │  ┌─────────┐  ┌──────────┐  ┌────────┐  │
+  │  │ Planner │  │ LLM Hub  │  │ Tools  │  │
+  │  │ (ReAct) │  │ (Multi)  │  │ Engine │  │
+  │  └────┬────┘  └────┬─────┘  └───┬────┘  │
+  │       │            │             │       │
+  │  ┌────┴────────────┴─────────────┴────┐  │
+  │  │        Go Micro-Worker             │  │
+  │  │   (Live Terminal Streaming)        │  │
+  │  └───────────────────────────────────┘  │
+  │                                          │
+  │  ┌─────────┐  ┌──────────┐  ┌────────┐  │
+  │  │ Memory  │  │ Browser  │  │ Cron / │  │
+  │  │ (AES)   │  │(Puppeteer│  │Hearbeat│  │
+  │  └─────────┘  └──────────┘  └────────┘  │
+  │                                          │
+  └──────────────────────────────────────────┘
+                │
+                ▼
+        MongoDB (Local, Encrypted)
 ```
 
 ---
 
+## 🗺️ Roadmap
+
+- [x] Full RPA Engine (Code → Commit → Deploy)
+- [x] Go Micro-Worker (Live Terminal Streaming)
+- [x] Puppeteer Browser DOM Controller
+- [x] Telegram Integration + Auto Tunnel
+- [x] Multi-Provider LLM (Gemini, Claude, DeepSeek, Qwen, OpenRouter, Ollama)
+- [x] Discord Bot Integration
+- [x] Groq/Whisper Voice Transcription
+- [x] Workspace Security Sandbox
+- [x] Heartbeat Periodic Tasks
+- [x] Sub-Agent Spawn (Background Workers)
+- [ ] WhatsApp Business API
+- [ ] Slack Integration
+- [ ] Docker Compose deployment
+- [ ] Mobile companion app
+
+---
+
 ## 📄 License
-MIT License • Built with ❤️ in India by **Bishnu Sahu**
 
-[Website](https://github.com/mebishnusahu0595) • [Discord Coming Soon] • [NPM](https://www.npmjs.com/package/samarthya-bot)
+**MIT License** — Built with ❤️ in India 🇮🇳 by **Bishnu Sahu**
+
+[GitHub](https://github.com/mebishnusahu0595) · [NPM](https://www.npmjs.com/package/samarthya-bot)

package/backend/.env.example

@@ -5,19 +5,43 @@ PORT=5000
 # Security (Required for Encrypted Vault)
 MEMORY_ENCRYPTION_KEY=generate_a_random_32_character_string_here
 
-# Optional Email Integration
-# SMTP_EMAIL=your_email@gmail.com
-# SMTP_PASSWORD=your_16_char_app_password
+# ═══════════════ AI PROVIDER SELECTION ═══════════════
+# Supported: gemini | ollama | anthropic | deepseek | qwen | openrouter | groq | openai | mistral
+ACTIVE_PROVIDER=gemini
+ACTIVE_MODEL=gemini-2.5-flash
 
-# Optional Desktop Application Features
+# ═══════════════ PROVIDER API KEYS ═══════════════
+# Set the key for whichever provider you use
+ANTHROPIC_API_KEY=your_anthropic_api_key
+DEEPSEEK_API_KEY=your_deepseek_api_key
+OPENROUTER_API_KEY=your_openrouter_api_key
+QWEN_API_KEY=your_qwen_api_key
+GROQ_API_KEY=your_groq_api_key
+
+# Ollama (local, free, offline — no API key needed)
 USE_OLLAMA=false
 OLLAMA_URL=http://localhost:11434
 OLLAMA_MODEL=llama3.2
-ACTIVE_PROVIDER=gemini
-ACTIVE_MODEL=gemini-2.5-flash-lite
 
-# Optional Telegram Remote Control (Connect via 'samarthya tunnel')
+# ═══════════════ CHANNELS ═══════════════
+# Telegram
 TELEGRAM_BOT_TOKEN=your_telegram_bot_api_key
 
+# Discord
+DISCORD_BOT_TOKEN=your_discord_bot_token
+DISCORD_ALLOW_FROM=your_discord_user_id
+
+# ═══════════════ VOICE TRANSCRIPTION ═══════════════
+# Groq Whisper — for Telegram voice note transcription
+# GROQ_API_KEY already set above — same key works for both LLM and Whisper
+
+# ═══════════════ SECURITY ═══════════════
+RESTRICT_TO_WORKSPACE=true
+HEARTBEAT_INTERVAL=30
+
+# ═══════════════ EMAIL (Optional) ═══════════════
+# SMTP_EMAIL=your_email@gmail.com
+# SMTP_PASSWORD=your_16_char_app_password
+
 # Node Environment
 NODE_ENV=production