A 4-tier autonomous AI agent system that replaces 10+ hours/week of manual business operations.
Not a chatbot. A full-time digital worker that monitors, drafts, routes, and executes — with human approval.
Solo founders and small agencies spend 10-15 hours/week on repetitive tasks:
- Reading and replying to emails
- Posting on social media
- Creating invoices and chasing payments
- Updating spreadsheets and dashboards
- Coordinating across platforms
An AI Employee that handles all of this 24/7, autonomously — while keeping humans in control of every decision that matters.
PLATINUM ──── Cloud VM (24/7) + Local Machine + Git Vault Sync
| Oracle Cloud orchestrator runs even when laptop is off
|
GOLD ────── Twitter + Facebook + Instagram + Slack + Odoo ERP
| Calendar integration + CEO Briefings + Audit logging
|
SILVER ───── Gmail OAuth + LinkedIn + WhatsApp + Obsidian Vault
| Human-in-the-loop approval workflow
|
BRONZE ───── Core agent loop + File processing + Planning engine
Foundation for all automation tiers
| Tier | What It Adds | MCP Servers |
|---|---|---|
| Bronze | Core agent loop, file watchers, planning engine | filesystem |
| Silver | Email, LinkedIn, WhatsApp, Obsidian GUI | +email, +linkedin, +browser |
| Gold | Twitter, FB/IG, Slack, Odoo, Calendar, CEO briefings | +twitter, +facebook-instagram, +slack, +odoo, +calendar |
| Platinum | Cloud VM 24/7, Git sync, claim-by-move, dual-agent | All 10 servers |
| Channel | Monitor | Draft Reply | Send | Approval |
|---|---|---|---|---|
| Gmail | Auto | AI-drafted | Via MCP | Required |
| Auto | AI-drafted | Human clicks | Required | |
| Slack | Auto | AI-drafted | Via MCP | Required |
| Platform | Draft | Post | Rate Limit |
|---|---|---|---|
| LinkedIn Personal | AI-drafted | Via MCP | 2/week |
| LinkedIn Company | AI-drafted | Via MCP | 2/week |
| Twitter/X | AI-drafted | Via MCP | Unlimited |
| AI-drafted | Via MCP | Unlimited | |
| AI-drafted | Via MCP | Unlimited |
| Function | Capability |
|---|---|
| Invoicing | Auto-create draft invoices in Odoo ERP |
| Payment Follow-ups | Auto-detect overdue, draft follow-up |
| Vendor Bills | Process and create in ERP |
| CEO Briefing | Weekly auto-generated business report |
| Calendar | Create events, find free slots |
| Accounting | Revenue summaries, bank reconciliation |
┌─────────────────────────────┐
│ Oracle Cloud VM │
│ (Always-On 24/7) │
│ │
│ cloud_orchestrator.py │
│ ├─ Email triage │
│ ├─ Social media drafts │
│ ├─ Odoo invoice drafts │
│ └─ Health monitoring │
└──────────┬──────────────────┘
│
Git Vault Sync
(GitHub Private)
│
┌──────────┴──────────────────┐
│ Local Machine │
│ │
│ platinum_orchestrator.py │
│ ├─ Gmail OAuth watcher │
│ ├─ WhatsApp watcher │
│ ├─ Approval executor │
│ ├─ Workflow runner │
│ └─ Dashboard updater │
└──────────┬──────────────────┘
│
┌──────────┴──────────────────┐
│ Obsidian Vault (GUI) │
│ │
│ Human reviews & approves │
│ in Markdown files │
└─────────────────────────────┘
linkedin ──────── Personal & Company page posts
email ─────────── Gmail: send, read, search, draft (OAuth2)
twitter ────────── Tweet, timeline, search
facebook-ig ───── Facebook + Instagram posts
odoo ────────────── 13 ERP tools (invoices, payments, partners, bills)
filesystem ────── Vault read/write/search/move
browser ─────────── Web automation (navigate, click, fill, screenshot)
calendar ────────── Google Calendar: events, free slots
slack ─────────── Messages, channels, status, file upload
(vault-sync) ──── Git-based sync between cloud & local
Human-in-the-loop by design. No message is sent, no payment is made, and no post goes live without explicit human approval.
| Rule | Description |
|---|---|
| Plan First | Every action requires a PLAN_*.md before execution |
| Human Approves | All outbound actions need sign-off |
| Draft Only | Accounting entries always created as DRAFT |
| Never Auto-Send | Human always clicks the final Send/Post |
| Audit Trail | Every action logged with timestamp |
| Rate Limited | Max 2 LinkedIn posts/week, 10 emails/hour |
Event detected (email / message / scheduled task)
│
▼
Watcher creates item in Needs_Action/
│
▼
AI creates PLAN_*.md ──► AI drafts response
│
▼
Pending_Approval/ (human reviews in Obsidian)
│
┌────┴────┐
▼ ▼
Approved/ Rejected/
│
▼
Executor sends via MCP ──► Audit log ──► Done/
| Metric | Result |
|---|---|
| Weekly time saved | 12+ hours |
| Email draft speed | < 5 minutes |
| Social posts/week | 4 (2 personal + 2 company) |
| System uptime | 24/7 (cloud VM) |
| Platforms integrated | 10 |
| Component | Technology |
|---|---|
| AI Brain | Claude Code (Opus 4) |
| Language | Python 3.9+ |
| Vault/GUI | Obsidian |
| Cloud | Oracle Cloud (Always Free) |
| ERP | Odoo 17 (Docker) |
| Integrations | 10 MCP Servers |
| Sync | Git (private repo) |
| Monitoring | systemd + health signals |
# Clone the repository
git clone https://github.com/Ub207/personal-ai-employee.git
cd personal-ai-employee
# Install dependencies
pip install -r requirements.txt
# Configure environment
cp .env.example .env
# Edit .env with your API keys
# Start the system
python platinum_orchestrator.py| Repo | Tier | Description |
|---|---|---|
| personal-ai-employee | Overview | Main system documentation |
| silver-tier-ai-employee | Silver | Email, LinkedIn, WhatsApp |
| gold-tier-ai-employee | Gold | Multi-platform + ERP |
| vault-sync | Platinum | Cloud-Local vault sync |
MIT License - see LICENSE for details.
Built by Ubaid ur Rahman
AI Automation Consulting for Solo Founders & Small Agencies
