# M3O

**Repository Path**: mirrors/M3O

## Basic Information

- **Project Name**: M3O
- **Description**: M3O 是 AWS 的开源替代方案——Go 实现的公有云平台
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://www.oschina.net/p/m3o
- **GVP Project**: No

## Statistics

- **Stars**: 17
- **Forks**: 4
- **Created**: 2021-11-15
- **Last Updated**: 2025-10-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# M3O [![License](https://img.shields.io/:license-apache-blue.svg)](https://opensource.org/licenses/Apache-2.0)

Serverless Micro Services 

## Overview

M3O transforms public APIs into smaller easier to use Micro services which you can explore, discover and consume 
as serverless building blocks. The platform generates unified api docs, client libraries and examples using protobuf to OpenAPI conversion and some custom tools. 

## Features

Here are the main features:

- **1️⃣ ONE Platform** - Discover, explore and consume public APIs all in one place. 
- **☝️ ONE Account** - Manage your API usage with one account and one token.
- **⚡ ONE Framework** - Learn, develop and integrate using one set of docs and libraries.

## Services

Here are a few APIs:

- [**Apps**](https://m3o.com/app) - Serverless app deployment
- [**Cache**](https://m3o.com/cache) - In-memory data storage
- [**Database**](https://m3o.com/db) - Serverless postgres database 
- [**Events**](https://m3o.com/event) - Push event notifications
- [**Users**](https://m3o.com/user) - Account management and authentication 
- [**Space**](https://m3o.com/space) - Infinite cloud storage

## Getting Started

- Head to [m3o.com](https://m3o.com) and signup for a free account.
- Browse services on the [Explore](https://m3o.com/explore) page.
- Call any service using your token in the `Authorization: Bearer [Token]` header
- All services are available through one API endpoint: `https://api.m3o.com/v1/*`.
- Use [m3o-cli](https://github.com/m3o/m3o-cli), [m3o-js](https://github.com/m3o/m3o-js) and [m3o-go](https://github.com/m3o/m3o-go) clients for development

## Quick Start

Grab your API token from the dashboard and export it

```
export M3O_API_TOKEN=xxxxxxx
```

### Curl

```bash
curl "https://api.m3o.com/v1/db/Create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $M3O_API_TOKEN" \
  -d '{
    "table": "notes",
    "record": {
      "name": "TODO",
      "list": ["eat", "sleep", "repeat"]
    }
  }'
```

Find all the curl examples in [m3o-sh](https://github.com/m3o/m3o-sh)

### Go

Import packages from [go.m3o.com](https://pkg.go.dev/go.m3o.com)

```go
import (
        "go.m3o.com"
        "go.m3o.com/db"
)
```

Create a new client with your API token and call it

```go
client := m3o.New(os.Getenv("M3O_API_TOKEN"))
rsp, err := client.Db.Create(&db.CreateRequest{
        Table: "notes",
        Record: map[string]interface{}{
                 "name": "TODO",
                 "list": []string{"eat", "sleep", "repeat"},
        },
})
fmt.Println(rsp, err)
```

Find all the Go examples in [m3o-go](https://github.com/m3o/m3o-go)

### JS

Install the [m3o](https://www.npmjs.com/package/m3o) package

```
npm install m3o
```

Call app run like so

```javascript
const m3o = require("m3o").default(process.env.M3O_API_TOKEN);

async function main() {
  let rsp = await m3o.db.create({
    table: "notes",
    record: {
      "name": "TODO",
      "list": ["eat", "sleep", "repeat"]
    }
  });
  console.log(rsp);
}

main();
```

Find more JS examples in [m3o-js](https://github.com/m3o/m3o-js)

### CLI

Install the cli

```
curl -fssl https://install.m3o.com/cli | /bin/bash
```

Example call

```
m3o db create --table=notes --record='{"name": "TODO", "list": ["eat", "sleep", "repeat"]}'
```

See the [m3o-cli](https://github.com/m3o/m3o-cli/tree/main/examples) for examples

## Deployment

1. See [Cloud](https://github.com/m3o/m3o/tree/main/cloud) for Infrastructure deployment
2. See [Platform](https://github.com/m3o/m3o/tree/main/platform) for Micro deployment 
3. See [API](https://github.com/m3o/m3o/tree/main/api) for Backend deployment
4. See [Web](https://github.com/m3o/m3o/tree/main/web) for Web deployment