Ragchat — The Local AI Agent for Private Workflows
Like n8n or Zapier, but runs 100% locally with absolute privacy. Ragchat seamlessly connects to Google Workspace, Microsoft 365, Telegram, and local files to automate workflows and query your data without sending information to the cloud.
ragchat bind google. See the 60-second setup guide below.Link your Gmail, Outlook, Google Drive, OneDrive, Telegram, or Discord accounts safely.
Your assistant reads and indexes your files locally on your own computer.
Query your knowledge base via chat or automate actions directly from your terminal.
Binding your custom Google OAuth credentials (via ragchat bind google) is a one-time process. Once bound, you can link up to 20 Google accounts and 20 Microsoft accounts seamlessly on your device.
Ragchat and click Create.Ragchat, and add your email.ragchat bind google in terminal. It auto-detects your downloaded JSON file from ~/Downloads!Why You'll Love RAGChat
Built to be simple, lightweight, and hassle-free for your daily work.
Consumes memory literally less than a few open tabs in your Chrome browser.
No complicated server configurations or API key tangles. Run one simple command and you are ready to go.
Find exact email answers, spreadsheet values, or doc paragraphs by asking simple everyday questions.
Your emails, login keys, and documents stay strictly on your local disk. Nothing is ever uploaded or sold.
Direct CLI commands let you list files and query inbox history without wasting expensive LLM API tokens.
Easily link multiple work and personal profiles across Google, Microsoft, Telegram, and Discord in one place.
Apps & Services You Can Connect
What's New in v1.1.6
Google OAuth logins now run completely locally on your machine via a local loopback server (`http://127.0.0.1:port`) using your custom bound `client_secret.json` keys, bypassing the Vercel gateway entirely.
Microsoft Graph integrations now include a robust token fallback helper. In scenarios where MSAL's local cache has not yet initialized, RAGChat seamlessly falls back to valid raw token variables to maintain sync operations.
The client now queries for updates in the background on launch. To ensure zero-latency command executions, updates are fetched asynchronously in a daemon thread, throttled locally to run at most once every 24 hours.
Easy Installation
Copy and paste the command below into your terminal app to get started in under a minute.
curl -fsSL https://raw.githubusercontent.com/soumen888/Rag-Chatbot/main/install/macos.sh | bash
irm https://raw.githubusercontent.com/soumen888/Rag-Chatbot/main/install/windows.ps1 | iex
Available Services & Commands
Google Workspace Commands
| Command | What It Does |
|---|---|
| ragchat bind google [file] | 1-time setup: Bind custom Google OAuth Client JSON with auto ~/Downloads detection Example: ragchat bind google |
| ragchat link google <profile> | Connect your Google account to start syncing emails & drive files Example: ragchat link google personal |
| ragchat profiles google | List all currently connected Google account profiles Example: ragchat profiles google |
| ragchat rename-profile google <old> <new> | Rename a saved Google account connection Example: ragchat rename-profile google dev work |
| ragchat -g <profile> <time> | Quickly check recent emails from specific timeframe (e.g. 10 hours, 2 days) Example: ragchat -g work 10h |
| ragchat sync google <profile> all | Sync all your historical emails into your local search Example: ragchat sync google work all |
| ragchat sheet <profile> list | List all spreadsheets in your Google Drive Example: ragchat sheet work list |
| ragchat sheet <profile> create <title> | Create a new Google Spreadsheet workbook Example: ragchat sheet work create "Project Expenses" |
| ragchat sheet <profile> <id> get-tabs | See all tab names inside a spreadsheet Example: ragchat sheet work <id> get-tabs |
| ragchat sheet <profile> <id> add-tab <tab> | Add a new tab to an existing spreadsheet Example: ragchat sheet work <id> add-tab "Q3 Summary" |
| ragchat sheet <profile> <id> append <range> <val> | Add a new row of data to your spreadsheet Example: ragchat sheet work <id> append "A1" "New Entry" |
| ragchat drive <profile> list | List your Google Drive files and folders Example: ragchat drive work list |
| ragchat drive <profile> list --filter <type> | Filter drive files by type (docs, sheets, or slides) Example: ragchat drive work list --filter docs |
| ragchat drive <profile> download <file_id> [path] | Download a file from Google Drive directly to disk (falls back to Desktop) Example: ragchat drive work download "1aBcXyZ..." "~/Downloads" |
| ragchat drive <profile> upload <local_path> [parent_id] | Upload a file or entire folder recursively to Google Drive (supports drag-and-drop) Example: ragchat drive work upload "~/Desktop/Report.pdf" |
Microsoft Workspace Commands
| Command | What It Does |
|---|---|
| ragchat link microsoft <profile> | Connect your Microsoft or Outlook account Example: ragchat link microsoft work |
| ragchat profiles microsoft | List all currently connected Microsoft account profiles Example: ragchat profiles microsoft |
| ragchat rename-profile microsoft <old> <new> | Rename a saved Microsoft account connection Example: ragchat rename-profile microsoft work main |
| ragchat -m <profile> <time> | Check recent Outlook emails from a specific timeframe Example: ragchat -m work 2d |
| ragchat sync microsoft <profile> all | Sync your complete Outlook inbox to your local computer Example: ragchat sync microsoft work all |
| ragchat onedrive <profile> list | List files and folders in your OneDrive Example: ragchat onedrive work list |
| ragchat onedrive <profile> list <path> | List files inside a specific folder in OneDrive Example: ragchat onedrive work list "Documents" |
| ragchat onedrive <profile> download <item_id> [path] | Download a file from OneDrive directly to disk (falls back to Desktop) Example: ragchat onedrive work download "01XYZ..." "~/Downloads" |
| ragchat onedrive <profile> upload <local_path> [parent_id] | Upload a file or entire folder recursively to OneDrive (supports drag-and-drop) Example: ragchat onedrive work upload "~/Desktop/Presentation.pptx" |
Social & Chat App Commands
| Command | What It Does |
|---|---|
| ragchat link telegram <profile> | Connect your Telegram account Example: ragchat link telegram main |
| ragchat telegram <profile> sync | Sync your saved Telegram channels & group chats Example: ragchat telegram main sync |
| ragchat link discord <profile> | Connect your Discord account or bot token Example: ragchat link discord dev |
| ragchat discord <profile> sync | Sync selected Discord server channels locally Example: ragchat discord dev sync |
Assistant Commands
| Command | What It Does |
|---|---|
| ragchat | Open the visual interactive menu in your terminal Example: ragchat |
| ragchat chat <collection> | Start asking questions to your AI assistant about your files Example: ragchat chat work_files |
| ragchat sync | Turn on background syncing so all apps stay automatically up to date Example: ragchat sync |
| ragchat update | Update the application and core binaries to the latest version Example: ragchat update |
| ragchat help | Show the helpful list of commands in terminal Example: ragchat --help |
Timeframe Shortcuts
Privacy & Security
RAGChat is designed to keep your workspace data private. Your files, search index, and settings reside on your own computer.
Stored Directly on Your Device
All your synced emails, files, and chat messages are saved strictly on your local computer hard drive.
Safe Account Sign-in
When you link Google or Microsoft, you log in through their official websites. Your passwords are never saved, and login passes stay safely on your computer.
Zero Data Tracking
We do not run tracking cookies, analytics scripts, or data harvesting algorithms.
🛡️ Security & Privacy Architecture
127.0.0.1 (localhost) and never broadcast credentials over external networks.ragchat_core) are compiled C extensions to ensure maximum performance and code integrity.github.com/soumen888/Rag-Chatbot or Homebrew tap brew install soumen888/ragchat/ragchat.