Skip to content

trohitg/MachinaOS

Repository files navigation

MachinaOS

npm version License: MIT Discord Ask DeepWiki

Personal AI Assistant/Co-Employees that Perform Human Like Tasks. Connect AI Assistant to your email, calendar, messages, phone, and more.

Mashup of N8N + Openclaw but with better visibility of what it's doing and also tighter control of what your AI Assistant can do.

See It In Action ↓

1_compressed.mp4

Full Capabilities ↓

fdemo_compressed.mp4

Prerequisites

Quick Start

npm install -g machinaos
machina start

Open http://localhost:3000

One-Line Install (auto-installs dependencies)

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/trohitg/MachinaOS/main/install.sh | bash

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/trohitg/MachinaOS/main/install.ps1 | iex
Clone & Run (for developers)

Development from source requires pnpm (enforced by scripts/preinstall.js via pnpm-workspace.yaml):

npm install -g pnpm           # one-time
git clone https://github.com/trohitg/MachinaOS.git
cd MachinaOS
pnpm install
pnpm run build
pnpm run dev

What You Can Build

Personal AI Assistants

Create AI agents that remember conversations, use tools, and work together. Choose from OpenAI, Claude, Gemini, DeepSeek, Kimi, Mistral, Groq, and 200+ models via OpenRouter.

Automate Your Google Workspace

  • Send and search emails
  • Create calendar events
  • Upload files to Drive
  • Update spreadsheets
  • Manage tasks and contacts

Universal Email (IMAP/SMTP)

  • Send, read, search, and manage emails via the Himalaya CLI
  • Works with Gmail, Outlook, Yahoo, iCloud, ProtonMail, Fastmail, or any custom IMAP/SMTP server
  • Polling-based trigger for incoming email workflows

Control Your Devices

  • Send WhatsApp messages automatically
  • Post to Twitter/X
  • Send Telegram messages via bot
  • Control your Android phone (WiFi, Bluetooth, apps, camera)
  • Schedule tasks and reminders

Browse the Web

  • Interactive browser automation with accessibility-tree navigation (agent-browser)
  • Web scraping with BeautifulSoup or Playwright (crawlee)
  • Route requests through residential proxies with geo-targeting
  • Run Apify actors for social media and search engine scraping
  • DuckDuckGo, Brave, Serper (Google), and Perplexity search

Plan Complex Tasks

  • writeTodos tool lets any AI agent create and update structured task lists
  • Real-time checklist rendering in the UI
  • Plan-work-update loop with pending / in_progress / completed states

Process Documents

  • Parse PDFs and documents
  • Search your files with AI

Build Agent Teams

                    +------------------+
                    |   AI Employee    |
                    |   (Team Lead)    |
                    +--------+---------+
                             | input-teammates
           +-----------------+------------------+
           |                 |                  |
    +------v------+   +------v------+   +-------v-----+
    | Coding Agent|   |  Web Agent  |   | Task Agent  |
    +-------------+   +-------------+   +-------------+
  • AI Employee / Orchestrator - Team lead agents for coordinating multiple specialized agents
  • Intelligent Delegation - AI decides when to delegate based on task context
  • Delegation Tools - Connected agents become delegate_to_* tools automatically
  • 16 Specialized Agents - Android, Coding, Web, Task, Social, Travel, Tool, Productivity, Payments, Consumer, Autonomous, Orchestrator, AI Employee, RLM, Claude Code, Deep Agent
  • Team Monitor - Real-time visualization of team operations

Run Code & Manage Processes

  • Execute Python, JavaScript, and TypeScript code
  • Persistent Node.js server for fast JS/TS execution
  • Process Manager - Start, stop, and manage long-running processes (dev servers, watchers, build tools) with output streaming to Terminal tab
  • OS-specific terminal skills (Bash, PowerShell, WSL)

Visual Workflow Builder

Drag-and-drop interface to connect AI models, services, and triggers. No code required.

Configuration

Click Credentials in the toolbar to add your API keys for AI providers, Google, WhatsApp, and Twitter.

Documentation

Full docs: https://docs.zeenie.xyz/

Community

Join our Discord for help, feedback, and updates.

Contributing

Want to add a node, LLM provider, skill, or integration? See CONTRIBUTING.md for the codebase map, architecture diagrams, development setup, and step-by-step recipes for common contributions.

License

MIT