Personal-AI-FTE

# Personal AI Employee (Digital FTE)

> **Your life and business on autopilot. Local-first, agent-driven, human-in-the-loop.**

A comprehensive blueprint and implementation framework for building a **Personal AI Employee** (Digital Full-Time Equivalent) powered by **Qwen Code** and **Obsidian**. This AI agent proactively manages personal and business affairs 24/7 using a local-first, privacy-focused architecture.

[![Status](https://img.shields.io/badge/status-bronze--complete-brightgreen)](https://github.com/MustafaYamin/Personal-AI-FTE.git)
[![Tier](https://img.shields.io/badge/tier-Bronze-orange)](https://github.com/MUSTAFA/Personal-AI-FTE)
[![Qwen Code](https://img.shields.io/badge/AI-Qwen%20Code-blue)](https://qwen.ai)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)

---

## 📋 Table of Contents

- [Overview](#overview)
- [Architecture](#architecture)
- [Achievement Tiers](#achievement-tiers)
- [✅ Bronze Tier - COMPLETE](#-bronze-tier---complete)
- [📋 Silver Tier - TODO](#-silver-tier---todo)
- [📋 Gold Tier - TODO](#-gold-tier---todo)
- [📋 Platinum Tier - TODO](#-platinum-tier---todo)
- [Quick Start](#quick-start)
- [Detailed Setup Guide](#detailed-setup-guide)
- [Usage](#usage)
- [Project Structure](#project-structure)
- [Configuration](#configuration)
- [Troubleshooting](#troubleshooting)
- [Contributing](#contributing)
- [License](#license)

---

## Overview

This project implements a **Digital FTE (Full-Time Equivalent)** - an AI agent that works like a human employee but with superhuman capabilities:

| Feature | Human FTE | Digital FTE |
|---------|-----------|-------------|
| Availability | 40 hours/week | **168 hours/week (24/7)** |
| Monthly Cost | $4,000 - $8,000+ | **$50 - $200** (API costs) |
| Ramp-up Time | 3-6 months | **Instant** |
| Consistency | 85-95% accuracy | **99%+ consistency** |
| Scaling | Linear (hire more) | **Exponential (duplicate instantly)** |
| Cost per Task | ~$5.00 | **~$0.50** |

**The 'Aha!' Moment:** A Digital FTE works 8,760 hours/year vs a human's 2,000 hours. That's **85-90% cost savings**—the threshold where CEOs approve projects without debate.

---

## Architecture

### Core Layers

```
┌─────────────────────────────────────────────────────────────┐
│                    PERSONAL AI EMPLOYEE                     │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│                    EXTERNAL SOURCES                         │
│    Gmail  │  WhatsApp  │  Bank APIs  │  Files  │  Social   │
└────────────────────────┬────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────────┐
│                  PERCEPTION LAYER (Watchers)                │
│  ┌────────────┐ ┌────────────┐ ┌────────────┐              │
│  │Gmail Watcher│ │WhatsApp Watcher│ │File Watcher│         │
│  │  (Python)  │ │ (Playwright)│ │  (Python)  │            │
│  └─────┬──────┘ └─────┬──────┘ └─────┬──────┘             │
└────────┼──────────────┼──────────────┼─────────────────────┘
         │              │              │
         ▼              ▼              ▼
┌─────────────────────────────────────────────────────────────┐
│                  OBSIDIAN VAULT (Memory)                    │
│  ┌──────────────────────────────────────────────────────┐  │
│  │ Dashboard.md │ Company_Handbook.md │ Business_Goals  │  │
│  ├──────────────────────────────────────────────────────┤  │
│  │ /Inbox │ /Needs_Action │ /Done │ /Plans │ /Approved  │  │
│  └──────────────────────────────────────────────────────┘  │
└────────────────────────┬────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────────┐
│                 REASONING LAYER (Qwen Code)                 │
│  ┌──────────────────────────────────────────────────────┐  │
│  │  Read → Think → Plan → Execute → Request Approval    │  │
│  └──────────────────────────────────────────────────────┘  │
└────────────────────────┬────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────────┐
│                    ACTION LAYER (MCP)                       │
│  ┌────────────┐ ┌────────────┐ ┌────────────┐              │
│  │ Email MCP  │ │Browser MCP │ │Payment MCP │              │
│  └────────────┘ └────────────┘ └────────────┘              │
└─────────────────────────────────────────────────────────────┘
```

### Key Components

| Layer | Component | Technology | Purpose |
|-------|-----------|------------|---------|
| **Brain** | Qwen Code | LLM | Reasoning engine |
| **Memory** | Obsidian | Markdown | Dashboard + long-term memory |
| **Senses** | Watcher Scripts | Python | Monitor Gmail, WhatsApp, files |
| **Hands** | MCP Servers | Node.js/Python | External actions |

---

## Achievement Tiers

This project follows a tiered development approach. Each tier builds on the previous one.

| Tier | Time | Status | Deliverables |
|------|------|--------|--------------|
| **Bronze** | 8-12h | ✅ **COMPLETE** | Vault, 1 Watcher, Qwen Code integration |
| **Silver** | 20-30h | 📋 TODO | Multiple Watchers, MCP server, HITL workflow |
| **Gold** | 40+h | 📋 TODO | Full integration, Odoo, social media, Ralph Wiggum loop |
| **Platinum** | 60+h | 📋 TODO | Cloud deployment, work-zone specialization |

---

## ✅ Bronze Tier - COMPLETE

### Achievements

- ✅ **Obsidian Vault Structure**
  - `Dashboard.md` - Real-time status dashboard
  - `Company_Handbook.md` - Rules of engagement
  - All required folders created and functional

- ✅ **Filesystem Watcher**
  - Real-time monitoring of `Inbox/` folder
  - Automatic action file creation in `Needs_Action/`
  - Uses Watchdog library for efficient file monitoring

- ✅ **Qwen Code Integration**
  - Orchestrator triggers Qwen Code for task processing
  - Output displayed in terminal
  - Automatic file movement to `Done/` after processing

- ✅ **Plan.md Generation**
  - Automatic complexity analysis of tasks
  - Plan files created for complex tasks (3+ steps)
  - Plan status updated on completion

- ✅ **Qwen Code Skill**
  - Documented skill in `.qwen/skills/ai-employee-bronze/`
  - Templates for plans, approvals, and logs
  - Registered in `skills-lock.json`

- ✅ **Logging System**
  - Daily log files in `/Logs/`
  - Processing entries with timestamps
  - Error tracking and debugging support

### Test Results

```
✅ Filesystem Watcher: Detects files in Inbox/
✅ Orchestrator: Triggers Qwen Code every 30s
✅ Qwen Code: Processes tasks and outputs to terminal
✅ File Movement: Tasks move to Done/ after processing
✅ Plan Generation: Complex tasks get Plan.md files
✅ Logging: All actions logged to /Logs/YYYY-MM-DD.log
```

---

## 📋 Silver Tier - TODO

### Planned Features

- [ ] **Second Watcher Script**
  - [ ] Gmail Watcher (monitor important emails)
  - [ ] OR WhatsApp Watcher (keyword-based message detection)

- [ ] **HITL Approval Workflow**
  - [ ] Process files in `/Pending_Approval/` folder
  - [ ] Execute actions when moved to `/Approved/`
  - [ ] Move rejected files to `/Rejected/`

- [ ] **MCP Server Integration**
  - [ ] Email MCP server (send responses)
  - [ ] OR Browser MCP (Playwright for web automation)

- [ ] **Task Scheduler**
  - [ ] Windows Task Scheduler setup script
  - [ ] Auto-start on system boot
  - [ ] Scheduled daily briefings

- [ ] **Enhanced Qwen Code Skill**
  - [ ] Multi-step task coordination
  - [ ] Better error handling
  - [ ] Context preservation across sessions

### Estimated Time: 20-30 hours

---

## 📋 Gold Tier - TODO

### Planned Features

- [ ] **Full Cross-Domain Integration**
  - [ ] Personal affairs (Gmail, WhatsApp, Bank)
  - [ ] Business operations (Social Media, Payments, Tasks)

- [ ] **Odoo Accounting Integration**
  - [ ] Local Odoo Community setup
  - [ ] MCP s

[truncated…]