samarthya-bot

v2.2.1

Published

9 days ago

SamarthyaBot — Privacy-First Local Agentic AI Operating System. Self-hosted multi-agent RPA engine with Telegram, Discord, Web Dashboard, Puppeteer browser control, SSH deployment, encrypted memory, voice transcription, and Indian workflow automation (GST

0High
0Medium
0Low

mebishnusahu0595

ai ai-agent agent artificial-intelligence machine-learning llm large-language-model gpt gemini claude ollama deepseek openrouter qwen chatbot chatgpt telegram-bot discord-bot whatsapp-bot rpa robotic-process-automation automation browser-automation puppeteer web-scraping ssh deployment devops cli command-line terminal nodejs node react mongodb express mern self-hosted privacy privacy-first local-ai offline-ai personal-assistant virtual-assistant ai-assistant indian india hindi hinglish gst upi irctc multi-agent autonomous agentic agentic-os operating-system workspace sandbox encrypted encrypted-memory aes-256 voice whisper speech-to-text plugin extensible plugin-system open-source samarthya samarthyabot code-generation code-assistant developer-tools productivity workflow-automation task-automation email-automation nodemailer cron heartbeat background-tasks socket-io realtime dashboard web-dashboard admin-panel react-dashboard made-in-india

🤔 What is SamarthyaBot?

SamarthyaBot (समर्थ्य बोट) is a privacy-first, self-hosted, multi-agent AI operating system that runs entirely on YOUR machine. Unlike cloud-based AI assistants, SamarthyaBot keeps all your data local, encrypted, and under your control.

It is not just a chatbot — it's a Full RPA (Robotic Process Automation) Agent that can:

✍️ Write code and commit to GitHub automatically
🚀 Deploy to servers via SSH (password or PEM key)
🌐 Control real browsers with Puppeteer (scrape, click, navigate, fill forms)
📧 Send real emails via SMTP — not simulations
🇮🇳 Handle Indian workflows — GST calculations, UPI payment links, IRCTC queries
🧠 Think autonomously using a ReAct planning engine
💬 Chat on Telegram, Discord, and Web Dashboard
🎙️ Understand voice messages via Groq/Whisper transcription
🔌 Extend with plugins — drop a .js file for new AI capabilities

SamarthyaBot is the most feature-rich, self-hosted AI agent built specifically for Indian developers. It supports Hindi, Hinglish, and English seamlessly, and works with 9 AI providers including free options like Gemini and Ollama (fully offline).

🌟 Why SamarthyaBot? (Key Differentiators)

✨ Features & Capabilities

🧠 Supported AI Providers

SamarthyaBot supports 9 AI providers — including free and fully offline options:

🚀 Quick Start — Install in 60 Seconds

Prerequisites: Node.js 20 LTS · MongoDB (local)
Get API keys: Gemini (Free) · Ollama (Free, Local)
Optional: Telegram Bot Token · Groq (Voice) · OpenRouter (100+ models)

📦 Install from NPM (Recommended)

# Install globally
npm install -g samarthya-bot

# Interactive setup wizard — configures AI keys, channels, everything
samarthya onboard

# Launch the engine + dashboard (Terminal 1)
samarthya gateway

# Expose to internet & link Telegram (Terminal 2)
samarthya tunnel

That's it! 🎉 Open http://localhost:5000 for the Dashboard.

🛠️ Install from Source (Development)

git clone https://github.com/mebishnusahu0595/SamarthyaBot.git
cd SamarthyaBot

# Install all dependencies
npm install

# Setup API keys interactively
samarthya onboard

# Start development server
npm run start

💬 Chat Channels & Integrations

Talk to SamarthyaBot on your favorite platform:

1. Create a bot

Open Telegram → search @BotFather
Send /newbot, follow prompts
Copy the token

2. Configure — Add to your .env:

TELEGRAM_BOT_TOKEN=YOUR_BOT_TOKEN

3. Run

# Terminal 1
samarthya gateway

# Terminal 2 (new terminal!)
samarthya tunnel

The tunnel automatically sets the webhook URL. You're live! 🚀

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:

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

samarthya gateway

🏆 Comparison with Alternative AI Agents

How does SamarthyaBot compare to other open-source AI agents?

| | 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 ✨ | | AI Providers | 1-2 | 3-4 | 9 Providers, 20+ Models |

⚙️ Configuration

All configuration is in backend/.env:

# ═══════════════ REQUIRED ═══════════════
GEMINI_API_KEY=your_gemini_api_key
MEMORY_ENCRYPTION_KEY=your_32_char_secret_key

# ═══════════════ AI PROVIDERS ═══════════════
ACTIVE_PROVIDER=gemini          # gemini | ollama | anthropic | openai | deepseek | openrouter | qwen | groq | mistral
ACTIVE_MODEL=gemini-2.5-flash

# Provider API Keys (set the one you use)
ANTHROPIC_API_KEY=
DEEPSEEK_API_KEY=
OPENROUTER_API_KEY=
OPENAI_API_KEY=
GROQ_API_KEY=
MISTRAL_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

🛠️ CLI Commands

🔌 Developing Plugins

Give your AI new superpowers — just drop a .js file:

// ~/SamarthyaBot_Files/plugins/weather.js
module.exports = {
    name: 'get_weather',
    description: 'Gets current weather for a city',
    parameters: {
        city: { type: 'string', required: true }
    },
    execute: async (args) => {
        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 — the agent can now check weather autonomously! 🌦️

💓 Heartbeat (Periodic Autonomous Tasks)

Create ~/SamarthyaBot_Files/HEARTBEAT.md to schedule autonomous tasks:

# 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).

🔒 Security & Privacy

🏗️ Architecture

  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)

📊 Use Cases & Real-World Examples

SamarthyaBot is designed for real-world automation:

🧑‍💻 Developers: "Samarthya, create a REST API with Express, push to GitHub, and deploy to my VPS"
📊 Business Owners: "Calculate GST for ₹50,000 at 18% and send invoice to [email protected]"
🎓 Students: "Research the latest papers on transformer architecture and summarize the top 5"
🏢 DevOps Engineers: "SSH into my server, check disk space, restart nginx if it's down"
📱 Content Creators: "Scrape trending topics from Twitter, summarize them, and post to my Discord"
🇮🇳 Indian Professionals: "Generate UPI payment link for ₹2,500, book Rajdhani ticket status, translate to Hindi"

❓ Frequently Asked Questions (FAQ)

What is SamarthyaBot?

SamarthyaBot is a privacy-first, self-hosted AI operating system that runs locally on your machine. It combines chatbot capabilities with full RPA (Robotic Process Automation) — meaning it can write code, deploy servers, control browsers, send emails, and automate Indian workflows like GST and UPI, all from a single Telegram message or web dashboard.

How do I install SamarthyaBot?

Install SamarthyaBot with a single NPM command: npm install -g samarthya-bot. Then run samarthya onboard for guided setup. Requires Node.js 20+ and MongoDB.

Is SamarthyaBot free?

Yes, SamarthyaBot is 100% free and open-source under the MIT license. It supports free AI providers like Google Gemini and Ollama (fully offline).

Does SamarthyaBot work offline?

Yes! Using Ollama as the AI provider, SamarthyaBot runs 100% offline with zero data leakage. No internet connection required after initial setup.

What AI models does SamarthyaBot support?

SamarthyaBot supports 9 AI providers with 20+ models: Google Gemini, Ollama (local), Anthropic Claude, OpenAI GPT, DeepSeek, Qwen, OpenRouter (100+ models), Groq, and Mistral.

Does SamarthyaBot support Hindi?

Yes! SamarthyaBot has first-class support for Hindi, Hinglish, and English. It's built specifically for Indian developers with Indian workflow support (GST, UPI, IRCTC).

Is my data safe with SamarthyaBot?

Absolutely. SamarthyaBot runs entirely on your local machine. All memories are encrypted with AES-256-CBC. Dangerous commands are blocked by regex blacklists. Your data never leaves your device.

How is SamarthyaBot different from ChatGPT?

Unlike ChatGPT, SamarthyaBot: (1) runs locally on your machine, (2) can execute real actions (deploy code, send emails, control browsers), (3) supports Indian workflows, (4) works offline via Ollama, and (5) your data never leaves your device.

Can SamarthyaBot deploy code to my server?

Yes! SamarthyaBot can SSH into remote servers using password or PEM key authentication, run commands, deploy code, and manage infrastructure — all from a simple chat message.

How do I create a plugin for SamarthyaBot?

Drop a .js file in ~/SamarthyaBot_Files/plugins/ with a name, description, parameters, and execute function. SamarthyaBot auto-discovers and loads it. See the Plugin Documentation above.

🗺️ 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, GPT, DeepSeek, Qwen, OpenRouter, Ollama, Groq, Mistral)
[x] Discord Bot Integration
[x] Groq/Whisper Voice Transcription
[x] Workspace Security Sandbox
[x] Heartbeat Periodic Tasks
[x] Sub-Agent Spawn (Background Workers)
[x] Premium CLI with ASCII Banner and Setup Wizard
[ ] WhatsApp Business API
[ ] Slack Integration
[ ] Docker Compose deployment
[ ] Mobile companion app
[ ] RAG (Retrieval-Augmented Generation) with local documents
[ ] Multi-user role-based access

📄 License

MIT License — Free to use, modify, and distribute.

Built with ❤️ in India 🇮🇳 by Bishnu Prasad Sahu

📦 NPM · 🐙 GitHub · 🐛 Report Bug · ✨ Request Feature

If SamarthyaBot helps you, consider giving it a ⭐ on GitHub!