MOP-AGENT

Self-hosted AI assistant with a real memory, an autonomous agent runtime, a scheduler, and multi-channel reach — installed with one command.

npx mop-agent install

What it is

MOP-AGENT is a self-hosted AI assistant you run on your own machine or server. It keeps a persistent, cross-session memory, can actually do work through an agent tool loop, schedules tasks and reminders that fire on their own, and reaches you across web, desktop, mobile, and messaging channels — all behind your own login, with an LLM router core so you can plug in any provider.

Key features

• Persistent memory — an Obsidian-style knowledge graph plus per-user profiles that deepen across sessions. Search your own past conversations.
• Agent runtime — a Hermes-style tool loop: read/write files, run commands (admin, with a destructive-command guard), web fetch & search, generate images, send files, and more.
• Scheduler — cron / one-off / interval jobs in natural language ("every morning at 8am"). Results are delivered to their own chat and as an OS push notification on desktop and phone.
• Email — SMTP send built in (encrypted at rest), so the agent can email reports and scheduled digests.
• Channels — Telegram, WhatsApp, Discord, Slack, Signal, IRC.
• Goals & self-improving skills — the agent records lasting objectives and distills reusable skills from complex tasks it completes.
• LLM router core — multiple providers, combos, failover, quota, and usage tracking. Exposes OpenAI-compatible /v1 and Anthropic /v1/messages endpoints.
• Multi-user + roles — real auth, admin vs. user surfaces.
• Client apps — installable PWA (iOS/Android/desktop) plus a native Tauri shell for Windows, Linux, and Android. See clients/tauri-shell.
• Push notifications — Web Push (VAPID) to every paired device.

Quick start

npx mop-agent install

The installer stages the app to a durable directory, installs dependencies, asks a few questions (deployment mode, domain, port, HTTPS), builds, and wires up a service so it starts on boot.

Other commands:

npx mop-agent            # interactive menu
npx mop-agent setup      # configure + build + service (skip OS deps)
npx mop-agent status     # health + file locations
npx mop-agent update     # rebuild + restart the current version
npx mop-agent delete     # remove service + reverse proxy (keeps data unless --purge)

Platform support

| Platform | How it runs | |----------|-------------| | Linux (Debian/Ubuntu, RHEL/Fedora, Arch, Alpine) | nginx reverse proxy + systemd service + Let's Encrypt (certbot) | | Windows | Native — builds and registers a logon Scheduled Task (no WSL2). Put IIS/Caddy/nginx in front for HTTPS | | macOS | Development only; deploy production on Linux |

Set MOP_AGENT_DIR to override the install directory (default /opt/mop-agent on Linux, %LOCALAPPDATA%\mop-agent on Windows).

Get the mobile / desktop app

Once your server is reachable (Cloudflare tunnel, Tailscale, or a domain), open Dashboard → Profile → Get the App:

• iOS — Safari → Share → Add to Home Screen (PWA, with push on iOS 16.4+).
• Android — install the PWA, or sideload the Tauri .apk.
• Windows / Linux — download the Tauri installer.
• Scan the pairing QR to point the app at your server automatically.

Configuration

The installer writes a .env with generated secrets. Key variables:

| Variable | Purpose | |----------|---------| | PORT | HTTP port (default 20128) | | DATA_DIR | SQLite + data directory | | JWT_SECRET | Session token signing | | MOP_SECRETS_KEY | AES key for channel/email secret encryption | | MOP_INTERNAL_TOKEN | Internal API token | | BASE_URL | Public URL |

Development

git clone https://github.com/BURHANDEV-ENTERPRISE/mop-agent.git
cd mop-agent
npm install
npm run dev        # http://localhost:20128
npm run build      # production build
npm start          # run the production server

License

UNLICENSED © BURHANDEV ENTERPRISE. All rights reserved.