Moro Agent

Self-hosted AI Agent Manager with a beautiful web UI. Create, manage and schedule autonomous AI agents powered by multiple LLM providers.

Features

• 🤖 Multi-Agent Management — Create and configure multiple AI agents with different personas and tools
• 🧠 Multi-Provider — OpenAI, Anthropic, Google Gemini, OpenRouter and more via Vercel AI SDK
• 🛠️ Custom Tools — Give agents custom tools (JavaScript / Python) to interact with the world
• ⏰ Scheduled Tasks — Cron-based task scheduling for automated agent runs
• 💬 Real-time Chat — WebSocket-powered live streaming chat with agents
• 🌐 Public Sharing — Share agents via public links with optional password protection

Quick Start

Prerequisites

Bun runtime ≥ 1.2 is required.

curl -fsSL https://bun.sh/install | bash

Install

bun add -g moro-agent

Run

# Start the server (runs as background daemon)
moro-agent start

# Open the web UI
open http://localhost:15123

That's it! The web UI is bundled and served automatically.

CLI Reference

moro-agent <command> [options]

Commands

| Command | Description | | --------- | ------------------------------------ | | start | Start the agent server (daemon mode) | | stop | Stop the running server | | restart | Restart the server | | status | Check if the server is running | | logs | View server logs | | version | Print version | | help | Show help |

Options

start / restart:

| Flag | Default | Description | | ------------------- | ------------------- | ----------------- | | --port <number> | 15123 | Server port | | --host <string> | 127.0.0.1 | Server host | | --data-dir <path> | ~/.moro-agent | Data directory | | -f, --foreground | — | Run in foreground |

logs:

| Flag | Default | Description | | ------------------ | ------- | ------------------------------ | | --lines <number> | 50 | Number of lines to show | | --follow | — | Tail the log file continuously |

Examples

# Start with custom port
moro-agent start --port 8080

# Expose to network
moro-agent start --host 0.0.0.0

# Run in foreground (useful for debugging)
moro-agent start --foreground

# View live logs
moro-agent logs --follow

# Check status
moro-agent status

# Stop the server
moro-agent stop

Data Storage

All data is stored in the data directory (~/.moro-agent by default):

~/.moro-agent/
├── data.db        # SQLite database (agents, conversations, settings)
├── agent.pid      # PID file (daemon mode)
└── agent.log      # Server logs (daemon mode)

Tech Stack

• Runtime: Bun
• Server: Hono — lightweight, fast HTTP framework
• Frontend: React 19 + TypeScript + Vite + Tailwind CSS
• Database: SQLite (bun:sqlite) + Drizzle ORM
• AI: Vercel AI SDK (ai, @ai-sdk/*)
• State: Redux Toolkit

Development

# Clone the repo
git clone https://github.com/devlangla/moro-agent.git
cd moro-agent

# Install dependencies
bun install

# Start dev servers (API + Vite HMR)
bun run dev

# Lint & format
bun run biome:check

License

MIT