Markus

Build AI teams that actually deliver.

Open-source AI workforce platform — role-based agents that plan, execute, review each other's work,
and deliver finished results. Runs around the clock on your machine or a small cloud server.

Website · Blog · Documentation · Discussions · Contributing

English | 中文

What is Markus?

Markus is an open-source platform that runs complete AI teams — not a wrapper around someone else's agents, and not just another framework.

Describe what you want done in plain language. Markus assembles the right roles (developer, reviewer, researcher, writer, analyst, ops), breaks the work into tasks, delegates to specialists, runs them in parallel, applies quality review, and ships the finished result.

It's the organizational layer that single-agent copilots are missing:

• Full agent runtime built in — every agent talks directly to LLM APIs and uses built-in tools: shell, file I/O, git, web search, code analysis, GUI & browser automation, and any MCP server. No proxying through external CLI tools.
• Zero config to start — SQLite storage, bundled web UI, one command. Nothing extra to install, nothing to configure.
• Manage from anywhere — a responsive dashboard for desktop and mobile, plus an Electron desktop app for macOS, Windows, and Linux. Deploy on any cloud server and run your AI company from your phone.

🚀 Quick Start

Pick whichever path is easiest.

Desktop app (macOS / Windows / Linux) — download from Releases.

npm (requires Node.js 22+):

npm install -g @markus-global/cli
markus start

Linux one-liner (works without Node.js):

curl -fsSL https://markus.global/install.sh | bash

From source:

git clone https://github.com/markus-global/markus.git && cd markus
pnpm install && pnpm build && pnpm dev

Open http://localhost:8056 — the onboarding wizard walks you through name, email, and password (initial login: [email protected] / markus123).

That's it. SQLite database, bundled web UI, zero external dependencies.

🎬 See It in Action

Real-time task board, agent chat, deliverable review, and team status — on desktop and mobile.

💼 What You Can Run on Markus

The same team keeps working after you close the laptop — heartbeats keep agents moving while you sleep.

✨ Key Features

How It Works

1. Describe what you need

Tell the built-in Secretary agent your goal in plain language. It assembles the right team, breaks down requirements into tasks, and sets up the project.

"I need a research team to scan competitor products, write a competitive analysis, and draft a go-to-market strategy."

2. Agents execute in parallel

Agents delegate, spawn subagents, review each other's work, and escalate only when they should. Each agent works in an isolated workspace with its own context. Developers write code, researchers compile findings, writers produce drafts — all at the same time.

3. Review and deliver

You review the final deliverables, not the process. Every output passes through quality gates, and the full audit trail shows exactly what each agent did, when, and why.

Single Agent vs. Markus Team

A single agent — Claude Code, Codex, ChatGPT, or any copilot — is great at executing one task at a time. But one employee doesn't make a company.

You manage a workforce, not individual prompts.

Architecture

┌─────────────────────────────────────────────────────────┐
│              Web UI (React) · Desktop (Electron)        │
│      Dashboard · Chat · Projects · Builder · Hub        │
└──────────────────────┬──────────────────────────────────┘
                       │ REST + WebSocket
┌──────────────────────┴──────────────────────────────────┐
│                  Org Manager (API Server)               │
│     Auth · Tasks · Governance · Projects · Reports      │
└──────────────────────┬──────────────────────────────────┘
                       │
┌──────────────────────┴──────────────────────────────────┐
│                  Agent Runtime (Core)                   │
│  Agent · LLM Router · Tools · Memory · Heartbeat · A2A  │
└──────────┬────────────────────────────┬─────────────────┘
           │                            │
┌──────────┴──────────┐    ┌────────────┴─────────────────┐
│  Storage (SQLite /  │    │  Comms (Slack, Feishu,       │
│   PostgreSQL)       │    │   WhatsApp, Telegram)        │
└─────────────────────┘    └──────────────────────────────┘

TypeScript monorepo with modular packages:

Documentation

Contributing

pnpm install && pnpm build
pnpm dev          # API + Web UI in dev mode
pnpm test         # Run tests
pnpm typecheck    # TypeScript check
pnpm lint         # ESLint

Looking for a way to contribute?

• Good first issues — beginner-friendly tasks
• Help wanted — features the community needs
• Bug reports — help us fix issues

See CONTRIBUTING.md for full guidelines.

License

Markus is dual-licensed:

• Open Source: AGPL-3.0 — free for self-hosting and community contributions
• Commercial: Available — for SaaS deployments and proprietary modifications

Agent templates and skills shared through the marketplace may use their own licenses (typically MIT).

Website · Blog · Discussions · Issues

_{Markus — Where AI Agents Work as a Team}