Skip to content

mutx-dev/mutx-dev

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,753 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

MUTX

Source-available control plane for running AI agents in production.

MUTX dashboard demo

Prototype an agent in an afternoon. Run one in production for a year — that's the hard part. Identity, deployments, sessions, health, access control, operator contracts. MUTX makes those explicit in running code, not whitepapers.

What's in the Box

Component What it does
Control Plane API FastAPI backend — /v1/* routes for auth, agents, deployments, sessions, runs, webhooks, budgets, swarms, RAG, and pico progress
Operator Dashboard Authenticated dashboard at app.mutx.dev/dashboard
Landing Site mutx.dev — narrative, quickstart, downloads
macOS App Signed & notarized desktop app via mutx.dev/download/macos
CLI + TUI mutx CLI and mutx tui — terminal-first workflows
Python SDK pip install mutx — full control plane access
Document Workflows predict-rlm-backed document analysis, comparison, extraction, and redaction across API, dashboard, CLI, and worker
Infrastructure Docker Compose (local), Terraform + Ansible (cloud), Helm (k8s)

Quick Start

brew tap mutx-dev/homebrew-tap && brew install mutx
mutx setup hosted

Hosted is the default. For the local Docker stack:

mutx setup local    # Docker-backed
mutx doctor         # Verify everything's wired

Development

make dev-up                                  # full stack (frontend + backend + Postgres + Redis)
uvicorn src.api.main:app --reload --port 8000  # backend only
npm run dev                                    # frontend only
URL What
localhost:3000 Landing site
localhost:3000/dashboard Operator dashboard
localhost:8000 API
localhost:8000/docs Swagger UI

Validation

./scripts/test.sh                        # full suite
npm run build                            # frontend build
npm run typecheck                        # TS gate
npm run test:app                         # frontend unit tests
ruff check src/api cli sdk  # Python lint
.venv/bin/python -m pytest               # API tests (from repo venv)
npx playwright test                       # e2e

Playwright starts a fresh local standalone server by default so worktree runs fail closed instead of silently reusing a stale build. Set PLAYWRIGHT_REUSE_EXISTING_SERVER=1 only when you intentionally want to target an already running local standalone server.

Architecture

mutx.dev ──────────── Next.js landing + releases + download
app.mutx.dev ──────── Dashboard + control demo + browser proxies
src/api/ ──────────── FastAPI control plane (/v1/*)
cli/ ──────────────── Click CLI + Textual TUI
sdk/mutx/ ─────────── Python SDK
infrastructure/ ───── Docker, Terraform, Ansible, Helm, monitoring
agents/ ───────────── Autonomous specialist agent definitions

Governance via Faramesh — policy enforcement, session budgets, phase workflows, credential brokering, rate limiting. Auth is RBAC + OIDC (Okta, Auth0, Azure AD, Keycloak).

Go Deeper

Built On

  • agent-run — observability standard
  • AARM — Autonomous Action Runtime Management
  • Faramesh — governance engine
  • Mission Control — fleet management
  • predict-rlm — document workflow engine and upstream example surface for analysis, comparison, invoice extraction, and redaction

Full attribution in CREDITS.md.

License

Source-available under BUSL-1.1. Each release converts to Apache-2.0 after 36 months. Python SDK is Apache-2.0. See LICENSE-FAQ.

Commercial use (hosted, managed, OEM) requires a license — hello@mutx.dev.