Open Source · MIT License

The Agentic Operating System
for Your Digital Life

Thinks, decides, and acts on your behalf. Connect WhatsApp, Telegram, Gmail, and 107+ tools — all orchestrated by a local-first LLM brain running on your own hardware.

You via WhatsApp

Check my email for any flight confirmations and forward them to my travel folder

Ubot

Found 2 flight confirmations from Emirates. Forwarded both to your Travel folder. ✈️ Your Dubai flight departs March 5 at 14:30.

Capabilities

Built for Edge Execution

Six composable layers — from Soul to Tools. Each capability is a plug-and-play module with its own AI instructions.

Messaging-Native I/O

Chat through WhatsApp, Telegram, or iMessage — the apps you already use. Full multi-turn conversations with context awareness across all channels simultaneously.

LLM Orchestrator

A decision engine powered by native OpenAI-compatible tool calling. Supports OpenAI, Claude, Gemini, and local Ollama — swap providers instantly.

Guided Autonomy via Skills

Two-phase skill matching: fast zero-LLM-cost filters, then LLM condition checks. Predictable automation pipelines with full AI reasoning within each stage.

Runtime Sandbox

WorkspaceGuard enforces strict filesystem isolation. Recursive path validation prevents traversal attacks. Contextual trust levels restrict visitor access to 11 safe tools.

107+ Native Tools

Auto-discovered tool modules across 16 categories — messaging, memory, files, scheduler, Google Workspace, web automation, and more. Extend further via MCP servers.

Markdown-as-Truth

Identity, personas, and skills are human-editable Markdown files. Hot-swap agent behavior by simply dropping an .agent.md file into a folder. Fully auditable and git-trackable.

Use Cases

One Agent, Endless Market Applications

From handling customers to automating operations to being your digital secretary — Ubot adapts to every role.

Front-Office Assistant

Customer Interface

Let Ubot handle incoming inquiries, appointment bookings, and customer support across all messaging channels — so you never miss a lead.

Auto-reply to inquiries 24/7
Book appointments natively in chat
Share catalogs
Route complex queries to human teams

Customer via WhatsApp

Hi, I'd like to book a table for 4 this Friday at 8pm

Ubot

Great choice! I've reserved a table for 4 this Friday at 8:00 PM. 🍽️ You'll receive a confirmation shortly. Would you like to see our weekend specials?

Back-Office Assistant

Automation Engine

Automate repetitive back-office tasks — from email triage and report generation to data entry and file management — all through simple chat commands.

Triage incoming emails
Organize and archive files locally
Scrape competitor pricing via Puppeteer
Generate daily data reports

You via Telegram

Summarize today's unread emails and flag anything urgent

Ubot

Done! You have 12 unread emails. 🚨 2 flagged as urgent: an overdue invoice from Acme Corp and a contract deadline reminder for Friday. I've moved the rest to categories.

Personal Proxy

Digital Secretary

Ubot acts as your personal proxy — replying to friends using your exact conversational style, managing social obligations, and keeping your life organized.

RSVP to events
Manage shopping lists
Reply to friends using your exact conversational style
Forward important updates to the right people

Friend via WhatsApp

Hey! Are you coming to the BBQ on Saturday?

Ubot

Hey! 👋 Yep, count me in! I'll bring dessert. What time should I be there? Can't wait! 🎉

Getting Started

How It Works

Three simple steps from installation to full automation.

01

Connect

Link messaging apps. Scan a QR code to be ready in seconds. WhatsApp, Telegram, and iMessage — all at once.

02

Command

Natural language requests. The LLM brain understands context and intent, then routes to the right skills and tools.

03

Automate

Ubot browses the web, sends emails, and manages files, reporting back automatically. All from a single chat.

Installation

Up and Running in Under 5 Minutes

Clone, build, install, and start — four commands is all it takes.

Terminal
#1Clone the repository
git clone https://github.com/Bigmints-com/ubot.git
#2Install dependencies
cd ubot && make deps
#3Build and install
make install
#4Launch Ubot
ubot start
Output

🤖 Starting Ubot on port 11490 ...

🤖 Ubot is running! (PID 73156)

🤖 Dashboard: http://localhost:11490

🤖 Logs: ubot logs

CLI Control

start · stop · status · logs

Config

~/.ubot/config.json

107+ Native Tools

16 modules · ~150MB RAM

Ecosystem

Built for Your Stack

Integrates with the tools and platforms you already use.

WhatsAppTelegramiMessageGmailGoogle SheetsGoogle DriveGoogle CalendarGoogle ContactsSaveADayPuppeteerDuckDuckGoOpenAIAnthropicGeminiOllamaMCPNode.jsTypeScriptSQLite
Architecture

The Technical Moat: Built for Edge Execution

Not a library. Not an SDK. An integrated persistent runtime optimized for local hardware.

Architecture
Ubot
Generic Frameworks
Model
Integrated Persistent Runtime
Library / SDK
Memory
Local-First, Durable SQLite
Ephemeral / External
I/O
Messaging-Native via WhatsApp/Telegram
CLI / API
Security
Runtime Sandbox / WorkspaceGuard
Application-Level
Logic
Guided Autonomy via Skills
Unpredictable Recursive Loops
Optimized for Edge Execution · Idles at ~150MB RAM
Security

Enterprise-Grade Privacy and Trust

Your data never leaves your machine. The only external calls are to the LLM API of your choice.

Local-First Sovereignty

All session logs, memories, and files stay on local SQLite databases and host storage. Zero cloud aggregation.

Strict Sandboxing

System access is forcefully confined to authorized workspaces only. Recursive path validation prevents traversal attacks.

Contextual Trust Levels

The Owner has access to 131+ tools. Visitors are strictly limited to a safe-list of just 11 tools.

Owner-in-the-Loop

The escalation protocol forces the agent to pause and request manual approval for any high-stakes action.

The Future of Agentic Intelligence is Local

Absolute privacy on your own hardware. Predictable autonomy via the multi-stage Skill Engine. Extensible via 107+ tools, MCP, and custom personas.

View on GitHub