Skip to content

Rohan-1920/Hackathon-0

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🤖 AI Autonomous Employee System

An intelligent automation system that acts as a virtual AI employee — monitoring tasks, managing workflows, and executing actions autonomously using Claude AI.

✨ Features

  • Autonomous Task Management — Monitors vault inbox and processes tasks automatically
  • Multi-tier Architecture — Bronze, Silver, and Platinum capability tiers
  • Approval Workflows — Human-in-the-loop approval for sensitive actions
  • Skill Orchestration — Modular skills for LinkedIn, email, file management, and CEO reports
  • Cloud + Local Agents — Hybrid system supporting both local and cloud deployments
  • MCP Server Integration — Email and external service integrations via Model Context Protocol
  • Scheduled Jobs — Cron-style task scheduling with intelligent reasoning loops
  • Advanced Logging — Structured logging with full audit trails

🏗️ Project Structure

project_root/
├── agents/
│   ├── core/          # Reasoning loop, scheduler, approval workflow
│   └── skills/        # LinkedIn, email, file, CEO report skills
├── cloud_agent/       # Cloud deployment agent
├── local_agent/       # Local execution agent
├── mcp_servers/       # MCP server integrations
├── watchers/          # Vault & Gmail watchers
├── vault/             # Obsidian-style task vault
├── config/            # Environment configuration
└── main.py            # Entry point

🚀 Quick Start

1. Clone & Setup

git clone https://github.com/Rohan-1920/Hackathon-0.git
cd Hackathon-0

2. Activate Virtual Environment

# Windows (Git Bash)
source venv/Scripts/activate

# Windows (PowerShell)
venv\Scripts\Activate.ps1

3. Install Dependencies

pip install -r requirements.txt

4. Configure Environment

cp config/.env.template config/.env
# Edit config/.env with your API credentials

5. Run the System

python main.py

🧠 How It Works

  1. Watchers monitor the vault Inbox/ for new task files
  2. Reasoning Loop analyzes tasks and decides on actions
  3. Skill Orchestrator routes tasks to the appropriate skill
  4. Approval Workflow flags sensitive actions for human review
  5. Scheduler handles recurring and time-based tasks

📦 Dependencies

Package Purpose
anthropic Claude AI client
watchdog File system monitoring
fastapi + uvicorn MCP server framework
schedule Task scheduling
python-dotenv Environment management
pydantic Data validation
requests HTTP client

🔐 Security Notes

  • Never commit .env files to version control
  • Keep API credentials secure
  • Review approval workflows before enabling full automation

📄 License

MIT License — feel free to use and modify.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors