moyai README

The project's README from github.com/BerriAI/moyai. As one markdown file: README.md.

Moyai

Moyai, an open source cloud agent

A self-hosted coding agent for background work. Give it a task from your browser or Slack; it edits code, runs tests, and opens a pull request for review. Send corrections while it works or resume with saved files and conversation history.

Search sessions by title, original request, or words inside saved user and assistant messages. Matching excerpts appear in the sidebar, including agent conversations and side chats. Search covers older sessions beyond the recent list and follows your selected My sessions/All sessions view. Archived sessions remain recoverable by asking Moyai in chat.

Ask “What is this session’s ID?” or send /session-id in web chat or Slack thread chat to get the current Moyai session ID directly. These standalone requests use no model calls, tool searches, or sandbox startup, and leave active work alone. Web replies are saved in the conversation; Slack replies use the same durable control-message delivery as status. Requests with attachments or additional work continue through the agent normally.

Harnesses

Supported harnesses: Claude Agent SDK, Codex, Hermes, OpenCode, Deep Agents, and Tool Loop

New sessions default to the native Claude Agent SDK with prompt caching enabled. You can pick a different harness for each session: Hermes, Claude Agent SDK, Codex, OpenCode, Deep Agents, or Tool Loop. Every harness runs in the same isolated workspace with the same tools and permissions. See supported combinations and custom harnesses.

Models and providers

Models and providers through LiteLLM: OpenAI, Anthropic, Google, Bedrock, Fireworks, xAI, Mistral, DeepSeek, Moonshot, and 100+ more

Moyai uses LiteLLM for inference, so it can run on any of the 100+ providers LiteLLM supports. Point it at your LiteLLM gateway, switch models between messages, and spend is tracked per teammate. Provider keys stay on the server, and the sandbox never sees them.

See it in action

moyai

Before vs after: 79% cheaper

We moved our internal coding agent from Devin to Moyai. Same work, same 31 days: $101,872 on Devin vs about $21,700 on Moyai

Before: Devin, $101,872 in 31 days

Devin billing dashboard showing $101,872.24 spent between Aug 30 and Sep 29

After: Moyai, about $700 a day

Running total over the same 31 days: Devin reaches $101,872 while Moyai reaches $21,700, saving $80,172

Read the full story in the launch post: Moyai is now open source

Getting started

Choose Modal or Substrate for agent sandboxes in Settings → Runtime. Modal is the default. If you already run Substrate, follow the linked setup to connect your cluster.

This setup runs Moyai on Modal, using GPT-6 Astra + the Claude Agent SDK harness through LiteLLM. You can choose another model or harness.

You'll need Git, Python 3.12+, uv, a Modal account, and a LiteLLM gateway with GPT-6 Astra enabled. Commands use a macOS/Linux shell; Windows users can use WSL.

1. Install

git clone https://github.com/BerriAI/moyai.git
cd moyai
uv sync --frozen
cp .env.example .env
chmod 600 .env

2. Add your credentials

Log in to Modal:

uv run modal token new

Open ~/.modal.toml in a private editor window. Copy your workspace's token_id and token_secret into .env, then fill in the model settings:

MODAL_TOKEN_ID=<your Modal token_id>
MODAL_TOKEN_SECRET=<your Modal token_secret>
LITELLM_API_BASE=https://your-gateway.example.com/v1
LITELLM_API_KEY=<your LiteLLM gateway key>
AGENT_MODEL=openai/gpt-6-astra
SESSION_TITLES_ENABLED=false

Ask your gateway administrator for the URL and a key with access to openai/gpt-6-astra through the Messages API. Leave the other settings unchanged for now, and keep .env out of Git and chat.

3. Deploy and sign in

Deployment starts billed compute. Use a fresh Modal workspace; redeploying an existing installation interrupts its active tasks.

uv run python deploy_modal.py

Open the printed Workspace URL. Sign in with WORKSPACE_PASSWORD from .env, which the script generates for you. It also sets up HTTPS and the required secrets. Keep this .env for future deployments.

4. Run your first task

Start a new session. Under Context & tools, choose Cloud session and leave the repository empty. Select Claude Agent SDK in the harness picker and GPT-6 Astra in the model picker, then send:

Create /workspace/hello.py that prints Hello from Moyai, run it, and show me the output.

The first run may take several minutes to build the agent image. Check Activity for the command output and Files for hello.py.

Next: connect your GitHub repository to work on your code and open PRs. Add Slack, Linear, or Notion when you need them.

To stop compute charges, stop the web app and remaining sandboxes in the Modal dashboard. Closing your browser leaves them running.

Documentation

moyai (BerriAI/moyai)

Searching Database…

266 ·GitHub
Moyai
What is this?Moyai is a self-hosted coding agent for background work: give it a task from your browser or Slack, and it edits code, runs tests, and opens a pull request for you to review.
Is this a hosted service or something I run myself?It is a self-hosted web app you deploy yourself, on Modal (default) or your own Substrate cluster, rather than a managed SaaS product.
How do I get it running?Install Git, Python 3.12+ and uv, clone and run the installer, copy your Modal tokens and LiteLLM gateway settings into .env, then deploy to Modal and sign in using the generated workspace password.
What accounts do I need before deploying?You need a Modal account and a LiteLLM gateway with a model enabled (the default guide uses GPT-6 Astra), plus Git, Python 3.12+, and uv locally.
Any gotchas when deploying?Deploying starts billed compute right away, and redeploying over an existing installation interrupts any tasks it is currently running; Windows users need WSL since commands assume a macOS/Linux shell.
Where do my provider API keys go?Provider keys stay on the Moyai server itself; the isolated sandbox where the agent actually edits code and runs commands never sees them.
What coding agent harnesses can I pick for a session?Each session can run on Hermes, the Claude Agent SDK, Codex, OpenCode, Deep Agents, or Tool Loop, all in the same isolated workspace with the same tools and permissions. New sessions default to the Claude Agent SDK with prompt caching enabled.
How much cheaper is Moyai than Devin?BerriAI moved its internal coding agent from Devin to Moyai and cut the same month of work from about $101,872 to roughly $21,700 — about 79% cheaper.
Can I interrupt or resume a running task?You can send corrections to the agent while it works, or resume a session later with its saved files and full conversation history.
Can I search through past agent sessions?Yes — search covers session titles, original requests, and words inside saved messages, with matching excerpts shown in the sidebar for both recent and older sessions.
What are similar projects?open-swe, orca, qm, pstack-claude, useagent, openrig, ordewell, Raven
Which topics is it in?pull-request, agentic-coding, slack, harness, opencode, coding-agents, sandbox, github, agent-orchestration, multi-agent, agents, coding-agent
Creator
BerriAI
Size
37.6 MB
Stars
266
Updated
CommitOct 17
Age
17d
Commits · 90 Days