Agent 开发框架

Melaya|受治理的 AI Agent 平台(官方 SDK 与开发文档仓)

Melaya

提供 AI Agent 可视化构建、设备/浏览器控制与远程 MCP 接入的受治理平台,本仓库仅含官方 SDK 与公开开发文档。

获取与使用

可连接

按官方资料配置客户端连接服务

使用难度待核验
国内可用性待核验

2026-11-09 更新 · 本站尚未实测

项目介绍

Agent 开发框架 · 2026-11-09 更新 · 本站尚未实测

Melaya 是一个面向“真正执行工作”的受治理 AI Agent 平台,宣称可在云端或用户自己的机器上运行,覆盖业务系统、真实浏览器标签页与真实 Android 应用。就当前公开仓库而言,它包含的是官方 SDK 与公开开发者文档;托管平台、Agent 运行时、Device Control 服务与 Browser Control 服务均为专有,不在本仓库内。README 同时指向独立的远程 MCP 仓库 melaya-labs/melaya-mcp,公共端点写作 https://api.melaya.org/mcp。

需要说明的是,本仓库带有 agent-framework 等标签,但 README 将产品分为 Agents、Assistant、Device Control、Browser Control、MCP Server、Marketing 等多个部分,并非单一可直接下载运行的“工作流文件”。本页信息依据 README 与 LICENSE,运行时细节以官方文档为准。

核心能力

点击能力名称查看输入、输出和原文依据。

README 列出的产品能力包括:以可视化方式编排工具、模型、记忆、子 Agent、知识、评测、调度、成本上限与人工审批;通过自然语言在已授权的业务系统中工作;让 AI 像人一样操作真实 Android 应用(点击、输入、滑动,无需目标应用提供 API);在真实浏览器标签页中执行并保留人工停止控制。

平台侧强调最小工具权限、加密 Connectors 保存凭据、租户隔离的项目与 API Key、服务端强制执行的人工审批,以及运行状态、追踪、成本、评测与取消。MCP 部分宣称提供 88 个限定作用域工具、覆盖 9 个权限域,采用 OAuth 2.1 + PKCE,无需粘贴 API Key。本仓库另提供 9 种语言的官方 SDK(Python、TypeScript/JavaScript、Go、Rust、Java、Kotlin、C#/.NET、Ruby、PHP),覆盖认证、项目、Connectors、流水线、模板、审计日志、设备管理、HITL、评测、计费等公开接口。

实际应用场景

适用场景

适合需要把 AI 能力落到实际业务动作、且希望以权限审批和成本上限加以约束的团队:例如跨业务系统处理任务、在无合适 API 的移动应用上执行操作、在浏览器中执行可观察流程,或通过 MCP 把 Melaya 执行层接入 Claude、Codex、Cursor、ChatGPT 等客户端。若只是需要一个本地可离线运行的单一 Agent 框架,本仓库并不提供该运行时。

安装与接入

README 给出的接入方式均为调用托管平台,不含平台本体部署步骤。MCP 可按原文命令添加:

claude mcp add --transport http melaya https://api.melaya.org/mcp
# or
codex mcp add melaya --url https://api.melaya.org/mcp

SDK 调用需要 Melaya 平台密钥(示例使用环境变量 MELAYA_API_KEY)。README 的快速开始为“配对手机”示例,并注明需要平台密钥;“无需目标应用 API”仅表示通过界面操作用户应用,不代表 SDK 不需要认证。Agent Skill 方面,README 给出在 Claude Code 中复制的原文命令:

git clone --depth 1 https://github.com/melaya-labs/melaya-mcp /tmp/melaya-mcp && cp -r /tmp/melaya-mcp/skills/melaya ~/.claude/skills/

其他助手可通过粘贴一句话安装 Skill,Claude.ai 与 Claude Desktop 则下载 zip 后在“Settings → Capabilities → Skills”上传。具体客户端配置以 melaya-mcp 仓库与官方文档为准;本仓库采集结果中缺少 MCP/服务端配置文件,相关配置待核验。

使用条件与限制

是否需要部署
服务入口见官方资料,客户端与认证要求见正文
是否需要注册
账号和认证要求见正文;未明确说明的项目仍待核验
是否需要 API Key
待核验
费用与额度
费用边界见正文,项目许可不代表模型或托管服务免费
所需权限
待核验
许可证与服务条款
待核验

权限费用与限制

平台按租户隔离,强调最小工具/应用白名单、加密 Connectors、敏感写入需人工审批,并要求不要把密钥写入源码、提示词、RAG 文档或 env_overrides。模型侧支持自带密钥,也提供无需自带密钥的 Melaya AI;README 列出 Ollama、LM Studio、OpenAI 兼容接口、LiteLLM、Claude Code、Codex、GitHub Copilot、Bedrock、Anthropic、Azure AI Foundry、OpenAI、Google Gemini、Grok、Groq、Hugging Face、Mistral、OpenRouter、Together AI、DeepSeek、Qwen(Alibaba)、Zhipu AI、MiniMax、Moonshot、SiliconFlow 等 48 个提供方,另有本地 runner 路径。费用方面,README 未给出具体价格,托管平台、云模型与第三方服务是否收费、如何计费均待向官方核验;开源 SDK 不代表平台与模型免费。设备控制依赖真实 Android 设备与配对,浏览器控制以扩展形式提供(Chrome、Edge、Brave、Opera、Firefox)。

国内使用情况

网友核验 用户经验分享

与站长实测独立,不代表官方认证或本站已实测。

我要核验
0 位参与者0 份有效分项记录

最近核验:暂无有效核验。参与人数按当前项目有效身份去重;不同核验项分别统计,不合并成用户总结果。仅统计审核通过且未过期的记录。

分项统计、有效期与样本量
核验项目有效人数成功 / 部分 / 失败 / 无法判断成功率最近核验 / 有效期
官方网站访问00 / 0 / 0 / 0样本不足暂无 / 7 天
GitHub 仓库访问00 / 0 / 0 / 0样本不足暂无 / 7 天
安装与运行00 / 0 / 0 / 0样本不足暂无 / 30 天
官方服务国内连接 / MCP 连接00 / 0 / 0 / 0样本不足暂无 / 30 天
国内网络情况00 / 0 / 0 / 0样本不足暂无 / 7 天
国内模型兼容性00 / 0 / 0 / 0样本不足暂无 / 30 天
自定义 API00 / 0 / 0 / 0样本不足暂无 / 30 天
海外服务依赖
00 / 0 / 0 / 0样本不足暂无 / 30 天
海外账号要求
00 / 0 / 0 / 0样本不足暂无 / 30 天
中文界面
00 / 0 / 0 / 0样本不足暂无 / 30 天
客户端兼容性00 / 0 / 0 / 0样本不足暂无 / 30 天
账号及费用信息
00 / 0 / 0 / 0样本不足暂无 / 30 天

成功率 = 成功 ÷(成功 + 部分成功 + 失败);无法判断不计入分母。至少 5 份可判断结果才显示成功率。账号、费用、海外依赖与语言等事实项,成功表示核查结论与资料吻合,具体观察另行统计;不表示免费或没有海外依赖。不同网络、客户端和版本的结果不能直接等同。

最近有效核验

暂无审核通过且未过期的网友核验。欢迎提交真实使用记录。

查看全部有效核验 →

国内实测状态:国内可用性待核验。协议兼容和官方资料说明不等于国内网络可用。

官方网站访问
尚未实测 待核验
GitHub 仓库访问
尚未实测 待核验
官方服务国内连接
尚未实测 待核验
国内网络情况
尚未实测 待核验
国内模型兼容性
尚未实测 待核验
自定义 API
尚未实测 待核验
海外服务依赖
尚未实测 待核验
海外账号要求
尚未实测 待核验
中文界面
尚未实测 待核验
国内最后核验时间
尚未实测

许可与国内使用

README 明确 SDK 代码与公开文档采用 Apache-2.0,仓库内附有 Apache License 2.0 全文;同时明确托管平台与引擎为专有、不包含在本仓库。GitHub API 的许可证识别为“Other/NOASSERTION”,最终以 LICENSE 文件与官方声明为准。第三方模型、云服务与 MCP 托管端点适用各自条款。README 未说明服务部署地域、数据存储位置、中国大陆可用性或合规资质,国内访问与数据出境问题均待核验;模型支持列表中出现国内厂商,并不等于服务可在国内合规使用。仓库无归档标记,但应关注后续维护状态。

项目资料与来源

官方网站 ↗

GitHub 仓库 ↗

官方文档 ↗

字段依据与待核验事项

access:来源确认 · claude mcp add --transport http melaya https://api.melaya.org/mcp

project_type:来源确认 · This public repository contains the **official SDKs and public developer documentation**. The hosted platform, agent runtime, Device Control service and Browser Control service are proprietary and are not included here.

原始 README(折叠技术参考)
<div align="center">

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="assets/brand/melaya_horizontal_dark.webp">
  <img src="assets/brand/melaya_horizontal_light.webp" width="380" alt="Melaya">
</picture>

### Governed AI agents that actually do the work

Melaya is a governed platform for AI agents that do real work — in the cloud or on your own machine — across your business systems, your browser, and real mobile apps.

[**Website**](https://melaya.org) · [**Documentation**](https://melaya.org/documentation) · [**MCP Server**](https://melaya.org/en/product/mcp) · [**Agent Skill**](#agent-skill-teach-any-ai-to-run-melaya) · [**Discord**](https://discord.gg/2BBMUUdnkj)

[![SDKs](https://img.shields.io/badge/SDKs-9_languages-6E56CF)](#official-sdks)
[![Tools](https://img.shields.io/badge/scoped_tools-8,200%2B-22D3EE)](#the-catalog)
[![Subagents](https://img.shields.io/badge/subagents-103-8B5CF6)](#the-catalog)
[![AI providers](https://img.shields.io/badge/AI_providers-48-F59E0B)](#bring-your-own-model)
[![MCP](https://img.shields.io/badge/MCP-88_tools-10B981)](https://github.com/melaya-labs/melaya-mcp)
[![Agent Skill](https://img.shields.io/badge/Agent_Skill-11_modules-EC4899)](https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](./LICENSE)

</div>

> This public repository contains the **official SDKs and public developer documentation**. The hosted platform, agent runtime, Device Control service and Browser Control service are proprietary and are not included here.
>
> Looking for the **remote MCP server**? It lives at **[melaya-labs/melaya-mcp](https://github.com/melaya-labs/melaya-mcp)** — one endpoint, `https://api.melaya.org/mcp`.

---

## The products

<table>
<tr>
<td width="60" align="center"><img src="assets/brand/melaya_got_an_idea.webp" width="42"></td>
<td><b>Melaya Agents</b> — <i>available now</i><br>A visual builder for high-trust AI workflows: tools, models, memory, subagents, knowledge, evaluations, schedules, cost limits and human approvals, composed as a pipeline.<br><a href="https://melaya.org/en/product/agentic-framework">Melaya Agents product page</a> · <a href="./docs/agent-builder.md">Docs</a></td>
</tr>
<tr>
<td align="center"><img src="assets/brand/melaya_happy.webp" width="42"></td>
<td><b>Melaya Assistant</b> — <i>available now</i><br>Work across your approved business systems in natural language, with permissions, execution and approvals still under your control.<br><a href="https://melaya.org/en/product/assistant">Melaya Assistant product page</a></td>
</tr>
<tr>
<td align="center"><img src="assets/brand/melaya_thumbs_up.webp" width="42"></td>
<td><b>Device Control</b> — <i>flagship, available now</i><br>Let an AI operate real Android apps the way a person does: tapping, typing, swiping and navigating through the visible interface. No vendor API, no integration. Per-app permissions and approval before sensitive actions.<br><a href="https://melaya.org/en/product/agentic-device-control">Device Control product page</a> · <a href="./docs/device-control.md">Docs</a></td>
</tr>
<tr>
<td align="center"><img src="assets/brand/melaya_studying.webp" width="42"></td>
<td><b>Browser Control</b> — <i>available now</i><br>The same governed execution in real browser tabs, with live visibility and a human stop control. Ships as a browser extension for Chrome, Edge, Brave, Opera and Firefox.<br><a href="https://melaya.org/en/product/agentic-browser-control">Browser Control product page</a> · <a href="https://addons.mozilla.org/en-US/firefox/addon/melaya/">Firefox add-on</a></td>
</tr>
<tr>
<td align="center"><img src="assets/brand/melaya_zen.webp" width="42"></td>
<td><b>MCP Server</b> — <i>available now</i><br>Give Claude, Codex, Cursor, ChatGPT or any compatible client access to Melaya's execution layer through <b>one remote endpoint</b>. 88 scoped tools across 9 permission domains, OAuth 2.1 + PKCE, no API key to paste.<br><a href="https://melaya.org/en/product/mcp">MCP Server product page</a> · <a href="https://github.com/melaya-labs/melaya-mcp">Repo</a> · <a href="./docs/mcp.md">Docs</a> · <a href="./skills/melaya">Agent Skill</a></td>
</tr>
<tr>
<td align="center"><img src="assets/brand/melaya_fire.webp" width="42"></td>
<td><b>Melaya Marketing</b> — <i>available now</i><br>One AI-native marketing cockpit. Connects your ads, search consoles, analytics, DNS and site, reads your <i>real</i> numbers server-side, and runs actions that do the work — SEO and page-speed audits, DNS hardening, wasted-spend cleanup — pausing for your approval before anything touches real money or your live site.<br><a href="https://melaya.org/en/product/marketing">Melaya Marketing product page</a></td>
</tr>
</table>

## The catalog

<div align="center">

| | | |
|:--:|:--:|:--:|
| **8,222** | **103** | **48** |
| scoped tools | specialized subagents | AI providers |
| **88** | **9** | **9** |
| MCP tools | official SDKs | MCP permission domains |

</div>

Runtime catalog endpoints remain the source of truth; the numbers above move as the catalog grows.

## Bring your own model

48 providers, chosen per agent. Credentials stay in encrypted Connectors, never in prompts or pipeline JSON.

### Local and self-hosted

Models on your own machine or your own server, reached through the Melaya runner. The data never leaves your network.

<table>
<tr><td align="center" width="25%"><img src="assets/providers/tiles/ollama.webp" width="52" alt="Ollama"><br><sub>Ollama</sub></td><td align="center" width="25%"><img src="assets/providers/tiles/lmstudio.webp" width="52" alt="LM Studio"><br><sub>LM Studio</sub></td><td align="center" width="25%"><img src="assets/providers/tiles/openai_compatible.webp" width="52" alt="OpenAI-Compatible"><br><sub>OpenAI-Compatible</sub></td><td align="center" width="25%"><img src="assets/providers/tiles/litellm.webp" width="52" alt="LiteLLM Proxy"><br><sub>LiteLLM Proxy</sub></td></tr>
</table>

### CLIs on your runner

Use the AI subscription you already pay for: the runner drives the official command-line tool on your machine.

<table>
<tr><td align="center" width="33%"><img src="assets/providers/tiles/claude_code.webp" width="52" alt="Claude Code"><br><sub>Claude Code</sub></td><td align="center" width="33%"><img src="assets/providers/tiles/codex.webp" width="52" alt="Codex"><br><sub>Codex</sub></td><td align="center" width="33%"><img src="assets/providers/tiles/github_copilot.webp" width="52" alt="GitHub Copilot"><br><sub>GitHub Copilot</sub></td></tr>
</table>

### Cloud

Frontier labs, open-model hosts and gateways. Bring your key, or use Melaya AI with no key at all.

<table>
<tr><td align="center" width="16%"><img src="assets/providers/tiles/melaya_ai.webp" width="52" alt="Melaya AI"><br><sub>Melaya AI</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/bedrock.webp" width="52" alt="Amazon Bedrock"><br><sub>Amazon Bedrock</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/anthropic.webp" width="52" alt="Anthropic"><br><sub>Anthropic</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/avis.webp" width="52" alt="Avis"><br><sub>Avis</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/azure_ai.webp" width="52" alt="Azure AI Foundry"><br><sub>Azure AI Foundry</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/baseten.webp" width="52" alt="Baseten"><br><sub>Baseten</sub></td></tr>
<tr><td align="center" width="16%"><img src="assets/providers/tiles/braintrust.webp" width="52" alt="Braintrust AI Gateway"><br><sub>Braintrust AI Gateway</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/cerebras.webp" width="52" alt="Cerebras"><br><sub>Cerebras</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/chutes.webp" width="52" alt="Chutes"><br><sub>Chutes</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/cohere.webp" width="52" alt="Cohere"><br><sub>Cohere</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/deepinfra.webp" width="52" alt="DeepInfra"><br><sub>DeepInfra</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/deepseek.webp" width="52" alt="DeepSeek"><br><sub>DeepSeek</sub></td></tr>
<tr><td align="center" width="16%"><img src="assets/providers/tiles/featherless.webp" width="52" alt="Featherless"><br><sub>Featherless</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/fireworks.webp" width="52" alt="Fireworks AI"><br><sub>Fireworks AI</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/friendli.webp" width="52" alt="FriendliAI"><br><sub>FriendliAI</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/gonka.webp" width="52" alt="Gonka"><br><sub>Gonka</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/google.webp" width="52" alt="Google Gemini"><br><sub>Google Gemini</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/grok.webp" width="52" alt="Grok (xAI)"><br><sub>Grok (xAI)</sub></td></tr>
<tr><td align="center" width="16%"><img src="assets/providers/tiles/groq.webp" width="52" alt="Groq"><br><sub>Groq</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/huggingface.webp" width="52" alt="Hugging Face"><br><sub>Hugging Face</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/minimax.webp" width="52" alt="MiniMax"><br><sub>MiniMax</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/mistral.webp" width="52" alt="Mistral AI"><br><sub>Mistral AI</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/modelrush.webp" width="52" alt="ModelRush"><br><sub>ModelRush</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/moonshot.webp" width="52" alt="Moonshot"><br><sub>Moonshot</sub></td></tr>
<tr><td align="center" width="16%"><img src="assets/providers/tiles/nebius.webp" width="52" alt="Nebius Token Factory"><br><sub>Nebius Token Factory</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/novita.webp" width="52" alt="Novita AI"><br><sub>Novita AI</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/nvidia.webp" width="52" alt="NVIDIA NIM"><br><sub>NVIDIA NIM</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/openai.webp" width="52" alt="OpenAI"><br><sub>OpenAI</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/openrouter.webp" width="52" alt="OpenRouter"><br><sub>OpenRouter</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/portkey.webp" width="52" alt="Portkey"><br><sub>Portkey</sub></td></tr>
<tr><td align="center" width="16%"><img src="assets/providers/tiles/qwen.webp" width="52" alt="Qwen (Alibaba)"><br><sub>Qwen (Alibaba)</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/reka.webp" width="52" alt="Reka AI"><br><sub>Reka AI</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/requesty.webp" width="52" alt="Requesty"><br><sub>Requesty</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/sambanova.webp" width="52" alt="SambaNova"><br><sub>SambaNova</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/scaleway.webp" width="52" alt="Scaleway Generative APIs"><br><sub>Scaleway Generative APIs</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/siliconflow.webp" width="52" alt="SiliconFlow"><br><sub>SiliconFlow</sub></td></tr>
<tr><td align="center" width="16%"><img src="assets/providers/tiles/together.webp" width="52" alt="Together AI"><br><sub>Together AI</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/upstage.webp" width="52" alt="Upstage Solar"><br><sub>Upstage Solar</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/vercel.webp" width="52" alt="Vercel AI Gateway"><br><sub>Vercel AI Gateway</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/writingmate.webp" width="52" alt="Writingmate"><br><sub>Writingmate</sub></td><td align="center" width="16%"><img src="assets/providers/tiles/zhipu.webp" width="52" alt="Zhipu AI"><br><sub>Zhipu AI</sub></td></tr>
</table>

## Why teams use Melaya

- Minimum-tool agent permissions instead of an unlimited toolbox
- Encrypted Connectors instead of credentials in prompts or pipeline JSON
- Tenant-scoped projects and API keys
- Human approval for consequential actions, enforced server-side
- Run status, traces, costs, evaluations, outputs and cancellation
- Cloud execution or a user-controlled local runner
- Mobile and browser workflows for products that expose no suitable API
- Nine official SDKs over the same public lifecycle

## Quick start: pair a phone

~~~ts
import { Melaya } from "@melaya/sdk";

const melaya = new Melaya({
  apiKey: process.env.MELAYA_API_KEY!
});

const { code, expiresInSeconds } =
  await melaya.agents.phone.pair();

console.log({ code, expiresInSeconds });

const devices = await melaya.agents.phone.listDevices();
const apps = await melaya.agents.phone.listApps();

await melaya.agents.phone.setAllowedApps([
  "com.android.chrome"
]);
~~~

A Melaya platform key is required. "No app API required" means Device Control operates the target app through its user interface; it does not mean the Melaya SDK is unauthenticated.

## Quick start: connect over MCP

No SDK, no key to paste. Add the endpoint to any compatible client and approve the scopes you want:

~~~bash
claude mcp add --transport http melaya https://api.melaya.org/mcp
# or
codex mcp add melaya --url https://api.melaya.org/mcp
~~~

Setup for Claude, ChatGPT, Cursor, VS Code, Le Chat, Gemini CLI, Zed, Cline, Goose and more: **[melaya-labs/melaya-mcp](https://github.com/melaya-labs/melaya-mcp)**.

## Agent Skill: teach any AI to run Melaya

The MCP server gives your assistant the tools. The **[Melaya skill](https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya)** gives it the method: connecting services, building and validating pipelines on real runs, triggers and approvals, reading results and handing work over. A free, open playbook your assistant reads before it acts, so it gets things right the first time.

**Any assistant** (ChatGPT, Gemini, Cursor, …): paste this line.

```text
Install the Melaya skill from https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya and use it whenever I ask you to work with Melaya.
```

**Claude Code**: copy it into your skills folder, then restart. It loads on its own when you mention Melaya.

```bash
git clone --depth 1 https://github.com/melaya-labs/melaya-mcp /tmp/melaya-mcp && cp -r /tmp/melaya-mcp/skills/melaya ~/.claude/skills/
```

**Claude.ai and Claude Desktop**: download [`skills/melaya`](https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya) as a .zip and upload it under **Settings → Capabilities → Skills**. Anywhere else, add [`SKILL.md`](https://github.com/melaya-labs/melaya-mcp/blob/main/skills/melaya/SKILL.md) as a project instruction or rules file.

The skill is one short router with the rules that always apply, plus eleven modules the assistant opens only when the task needs them:

<table>
<tr><td width="50%" valign="top"><a href="https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya/modules/quickstart"><b>quickstart</b></a><br><sub>Plain-language journeys for non-technical users</sub></td><td width="50%" valign="top"><a href="https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya/modules/discovery"><b>discovery</b></a><br><sub>Finding the right tools, templates and connected services</sub></td></tr>
<tr><td width="50%" valign="top"><a href="https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya/modules/runners-models"><b>runners-models</b></a><br><sub>The runner and models: Claude Code, Codex, Copilot, Ollama, LM Studio, cloud</sub></td><td width="50%" valign="top"><a href="https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya/modules/projects-templates"><b>projects-templates</b></a><br><sub>Projects, teams and starting from a validated template</sub></td></tr>
<tr><td width="50%" valign="top"><a href="https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya/modules/pipeline-authoring"><b>pipeline-authoring</b></a><br><sub>Pipeline configs that generate and run correctly</sub></td><td width="50%" valign="top"><a href="https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya/modules/agentic-systems"><b>agentic-systems</b></a><br><sub>Complete multi-pipeline systems, designed end to end</sub></td></tr>
<tr><td width="50%" valign="top"><a href="https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya/modules/data-spine"><b>data-spine</b></a><br><sub>Google Sheets data stores, bulk scoring, clean records</sub></td><td width="50%" valign="top"><a href="https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya/modules/automation-governance"><b>automation-governance</b></a><br><sub>Schedules, event triggers, approvals and cost limits</sub></td></tr>
<tr><td width="50%" valign="top"><a href="https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya/modules/validate-debug"><b>validate-debug</b></a><br><sub>Proving a pipeline on real runs and fixing what fails</sub></td><td width="50%" valign="top"><a href="https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya/modules/client-handover"><b>client-handover</b></a><br><sub>Documentation and handover for the people who will use it</sub></td></tr>
<tr><td width="50%" valign="top"><a href="https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya/modules/devices-browser"><b>devices-browser</b></a><br><sub>Agents that use a phone or a browser like a person</sub></td><td width="50%"></td></tr>
</table>

## Official SDKs

<div align="center">

| | Language | Package |
|:--:|---|---|
| <img src="assets/packages/python.png" height="22"> | Python | [melaya](./packages/sdk-python) |
| | TypeScript / JavaScript | [@melaya/sdk](./packages/sdk) |
| <img src="assets/packages/go.png" height="22"> | Go | [melaya-go](./packages/sdk-go) |
| <img src="assets/packages/rust.png" height="22"> | Rust | [melaya](./packages/sdk-rust) |
| <img src="assets/packages/java.png" height="22"> | Java | [org.melaya:melaya-sdk](./packages/sdk-java) |
| <img src="assets/packages/kotlin.png" height="22"> | Kotlin | [org.melaya:melaya-sdk-kotlin](./packages/sdk-kotlin) |
| <img src="assets/packages/c-sharp.png" height="22"> | C# / .NET | [Melaya.SDK](./packages/sdk-csharp) |
| <img src="assets/packages/ruby.png" height="22"> | Ruby | [melaya](./packages/sdk-ruby) |
| <img src="assets/packages/php.png" height="22"> | PHP | [melaya/sdk](./packages/sdk-php) |

</div>

The supported public surface includes authentication, projects, Connectors (personal and project-shared), credentials, connector tool calls (discover and call the tools your connected services unlock, with an in-app approval for writes), pipelines with run inputs and file uploads, pipeline documents (static context and RAG), templates, Agent Builder tools, the tool-call audit log, Device Control management, HITL, evaluations, events, billing, account operations, runner management, team management, MFA, the assistant, bug reports and agent memory.

What the SDKs drive: [Melaya Agents](https://melaya.org/en/product/agentic-framework) pipelines and runs, the [Melaya Assistant](https://melaya.org/en/product/assistant), [Device Control](https://melaya.org/en/product/agentic-device-control) on real Android apps, [Browser Control](https://melaya.org/en/product/agentic-browser-control), and the same execution layer behind the [MCP Server](https://melaya.org/en/product/mcp) and [Melaya Marketing](https://melaya.org/en/product/marketing).

Internal operator APIs are intentionally absent.

## Security rules for SDK users

- Keep **MELAYA_API_KEY** in a secret manager or server environment.
- Store model and external-service credentials in Connectors.
- Do not put secrets in source, prompts, RAG documents, artifacts, or **env_overrides**.
- Give agents the smallest practical tool and app allowlists.
- Require human approval for consequential writes.
- Validate errors and final state before reporting success.
- Revoke unused platform keys and paired devices.
- Redact credentials from proxy, APM, and WebSocket query logs.

See [Security and trust](./docs/security.md).

## Documentation

- [Melaya Agents](./docs/agent-builder.md)
- [Device Control](./docs/device-control.md)
- [MCP Server](./docs/mcp.md)
- [Agent Skill](https://github.com/melaya-labs/melaya-mcp/tree/main/skills/melaya)
- [Concepts](./docs/concepts.md)
- [Security and trust](./docs/security.md)
- [FAQ](./docs/faq.md)
- [Comparison](./docs/comparison.md)

Full product documentation and interactive API reference: [melaya.org/documentation](https://melaya.org/documentation).

## Where to find us

Melaya is listed across the MCP registries and the product directories below.
Every link was fetched and confirmed live on 2026-09-21.

**Product directories**

[![Product Hunt](https://img.shields.io/badge/Product_Hunt-Melaya-DA552F)](https://www.producthunt.com/products/melaya)
[![AlternativeTo](https://img.shields.io/badge/AlternativeTo-Melaya-5B7FBB)](https://alternativeto.net/software/melaya/about/)
[![SaaSHub](https://img.shields.io/badge/SaaSHub-Melaya-2A6FDB)](https://www.saashub.com/melaya)
[![SourceForge](https://img.shields.io/badge/SourceForge-Melaya-FF6600)](https://sourceforge.net/software/product/Melaya/)
[![Slashdot](https://img.shields.io/badge/Slashdot-Melaya-004242)](https://slashdot.org/software/p/Melaya/)
[![Indie Hackers](https://img.shields.io/badge/Indie_Hackers-Melaya-0E2439)](https://www.indiehackers.com/product/melaya)

**AI agent directories**

[![AI Agents Directory](https://img.shields.io/badge/AI_Agents_Directory-Melaya-7C3AED)](https://aiagentsdirectory.com/agent/melaya)
[![AgentLocker](https://img.shields.io/badge/AgentLocker-Melaya-0F766E)](https://agentlocker.ai/agent/melaya)
[![AI Tool Seekers](https://img.shields.io/badge/AI_Tool_Seekers-Melaya-DB2777)](https://aitoolseekers.com/tools/melaya)

**MCP ecosystem**

[![MCP Registry](https://img.shields.io/badge/MCP_Registry-org.melaya%2Fmelaya-6E56CF)](https://registry.modelcontextprotocol.io)
[![Glama](https://img.shields.io/badge/Glama-melaya--mcp-22D3EE)](https://glama.ai/mcp/servers/@melaya-labs/melaya-mcp)
[![mcp.so](https://img.shields.io/badge/mcp.so-melaya-8B5CF6)](https://mcp.so/servers/melaya-1f614a)
[![Smithery](https://img.shields.io/badge/Smithery-melaya-8B5CF6)](https://smithery.ai/servers/info-h530/melaya)
[![mcpserver.dev](https://img.shields.io/badge/mcpserver.dev-melaya-10B981)](https://mcpserver.dev/s/melaya_1f0eb4j)
[![MCP Market](https://img.shields.io/badge/MCP_Market-melaya-F59E0B)](https://mcpmarket.com/server/melaya)
[![Cursor Directory](https://img.shields.io/badge/Cursor_Directory-melaya-0EA5E9)](https://cursor.directory/plugins/melaya)

<sub>Also on <a href="https://launchkiwi.com/p/melaya">LaunchKiwi</a> · <a href="https://makerhunt.io/project/melaya">MakerHunt</a> · <a href="https://launchnest.io/p/melaya">LaunchNest</a> · <a href="https://www.foundrlist.com/product/melaya">FoundrList</a> · <a href="https://launchpadly.co/startup/melaya">Launchpadly</a> · <a href="https://launchigniter.com/product/melaya">LaunchIgniter</a> · <a href="https://tools.launchllama.co/products/melaya">Launch Llama</a> · <a href="https://thesaasdir.com/product/melaya/">The SaaS Dir</a> · <a href="https://getprojectradar.com/notes/melaya">ProjectRadar</a> · <a href="https://topbusinesssoftware.com/products/Melaya/reviews/">TopBusinessSoftware</a> · <a href="https://hackernoon.com/u/melaya">HackerNoon</a></sub>

## License

The SDK code and public documentation are licensed under [Apache-2.0](./LICENSE). The hosted platform and engines are proprietary and are not included in this repository.

Third-party names and logos are used only for identification and do not imply endorsement.

<div align="center">
<br>
<img src="assets/brand/melaya_party.webp" width="70"><br>
<sub><b>Melaya Labs</b> · <a href="https://melaya.org">melaya.org</a> · <a href="https://discord.gg/2BBMUUdnkj">Discord</a></sub>
</div>
历史前置条件说明(补充参考)

需要 Melaya 平台账号与平台密钥(MELAYA_API_KEY);MCP 接入使用 OAuth 2.1 + PKCE 授权;模型可自带 API Key 或使用 Melaya AI;设备控制需要可配对的 Android 设备,浏览器控制需要相应浏览器扩展;托管平台与运行时不在开源仓库内,部署与计费方式待核验;国内网络可用性与数据存储地域待核验。

项目来源与清单版权许可

https://github.com/melaya-labs/melaya

整理来源:https://github.com/slavakurilyak/awesome-ai-agents

清单版权与许可:

MIT License

Copyright (c) 2024 Slava Kurilyak

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.