meowdis

KO | EN

gitlite — search

#javascript #react #ai #typescript #llm #go #rust #deep-learning #windows #awesome #awesome-list #security #ios #openai

(★ 16)

free, serverless redis clone backed by cloudflare durable objects

meowdis 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## meowdis

a free, serverless redis clone backed by cloudflare durable
objects. drop-in replacement for upstash redis.

### features

- upstash compatible api (works w upstash sdks)
- redis over http(s) / http compatible key-value store
- pipelining support
- free storage backed by cloudflare durable objects
- low memory footprint <3 lambda go runtime

### supported [redis 8.2](https://redis.io/docs/latest/commands/redis-8-2-commands/) commands

| category | commands                                                                          |
| -------- | --------------------------------------------------------------------------------- |
| strings  | `GET`, `SET`, `DEL`, `EXISTS`, `INCR`, `INCRBY`, `DECR`, `DECRBY`, `MGET`, `MSET` |
| expiry   | `EXPIRE`, `EXPIREAT`, `TTL`, `PTTL`, `PERSIST`                                    |
| hashes   | `HGET`, `HSET`, `HDEL`, `HGETALL`, `HEXISTS`, `HKEYS`, `HVALS`                    |
| lists    | `LPUSH`, `RPUSH`, `LPOP`, `RPOP`, `LRANGE`, `LLEN`                                |
| sets     | `SADD`, `SREM`, `SMEMBERS`, `SISMEMBER`, `SCARD`                                  |
| utility  | `PING`, `DBSIZE`, `FLUSHDB`, `KEYS`                                               |

`SET` options: `NX`, `XX`, `GET`, `EX`, `PX`, `EXAT`, `PXAT`, `KEEPTTL`

`EXPIRE` / `EXPIREAT` options: `NX`, `XX`, `GT`, `LT`

`LPOP` / `RPOP` options: `count`

### how it works (basically)

- a compute layer exposes a POST endpoint
- accepts upstash redis commands in the request body
- translates the command into sqlite queries
- forwards the queries to the storage layer, a durable object instance
- durable object executes the queries against its sqlite database and returns
  the result
- compute layer returns the result to the client

### setup

#### deploy with one click (recommended)

set `AUTH_TOKEN` to a random secret string when prompted — generate one at
[jwtsecretkeygenerator.com](https://jwtsecretkeygenerator.com/)

[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/zion-off/meowdis/tree/main/meowdis)

> **tip:** for lower latency, set a [location hint](https://developers.cloudflare.com/durable-objects/reference/data-location/#provide-a-location-hint) in `meowdis/src/index.ts` before deploying to pin the durable object to a region close to your users:
>
> ```ts
> const stub = env.STORAGE.get(id, { locationHint: "apac" });
> ```

then initialise the database:

```bash
curl https://meowdis.example.workers.dev \
  -H "Authorization: Bearer your-token" \
  -d '["INIT"]'
```

verify it's working:

```bash
curl https://meowdis.example.workers.dev \
  -H "Authorization: Bearer your-token" \
  -d '["PING"]'                       # {"result":"PONG"}
```

### usage examples

**python**

```python
from upstash_redis import Redis

redis = Redis(url="https://meowdis.example.workers.dev", token="your-token")

redis.ping()                          # 'PONG'
redis.set("name", "clairo")           # 'OK'
redis.get("name")                     # 'clairo'
```

**node**

```typescript
import { Redis } from "@upstash/redis";

const redis = new Redis({
  url: "https://meowdis.example.workers.dev",
  token: "your-token",
});

await redis.ping(); // 'PONG'
await redis.set("name", "clairo"); // 'OK'
await redis.get("name"); // 'clairo'
```

**rest** (see
[upstash rest api docs](https://upstash.com/docs/redis/features/restapi))

```bash
curl https://meowdis.example.workers.dev \
  -H "Authorization: Bearer your-token" \
  -d '["PING"]'                       # {"result":"PONG"}

curl https://meowdis.example.workers.dev \
  -H "Authorization: Bearer your-token" \
  -d '["SET", "name", "clairo"]'      # {"result":"OK"}

curl https://meowdis.example.workers.dev \
  -H "Authorization: Bearer your-token" \
  -d '["GET", "name"]'                # {"result":"clairo"}
```

### alternate setup

#### deploy storage and compute separately

**1.** deploy the storage layer

[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/zion-off/meowdis/tree/main/durable-object)

| variable         | description                                                                                               |
| ---------------- | --------------------------------------------------------------------------------------------------------- |
| `STORAGE_SECRET` | a random secret string -- generate one at [jwtsecretkeygenerator.com](https://jwtsecretkeygenerator.com/) |

**2.** deploy the compute layer

**option a — cloudflare worker** (compute-node)

[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/zion-off/meowdis/tree/main/compute-node)

| variable     | description                                                                                               |
| ------------ | --------------------------------------------------------------------------------------------------------- |
| `AUTH_TOKEN` | a random secret string -- generate one at [jwtsecretkeygenerator.com](https://jwtsecretkeygenerator.com/) |

**option b — aws lambda** (compute-go)

| variable           | description                                                                                               |
| ------------------ | --------------------------------------------------------------------------------------------------------- |
| `AUTH_TOKEN`       | a random secret string -- generate one at [jwtsecretkeygenerator.com](https://jwtsecretkeygenerator.com/) |
| `STORAGE_ENDPOINT` | url of your deployed durable object worker                                                                |
| `STORAGE_TOKEN`    | the `STORAGE_SECRET` you set on the storage layer                                                         |

**3.** initialise the database

```bash
curl https://your-compute-endpoint \
  -H "Authorization: Bearer your-token" \
  -d '["INIT"]'
```

**4.** verify it's working

```bash
curl https://your-compute-endpoint \
  -H "Authorization: Bearer your-token" \
  -d '["PING"]'                       # {"result":"PONG"}
```

meowdis

meowdis 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

meowdis

meowdis 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README