Gedis - Redis-compatible Cache Server

A high-performance in-memory caching solution written in Go

Features • Architecture • Installation • Quick Start • Commands • Client

Overview

Gedis is a lightweight, in-memory key-value store server that implements the RESP (REdis Serialization Protocol) specification. It provides a simple and efficient way to store and retrieve data over TCP connections. Built with Go, it offers high performance and concurrent connection handling while maintaining a simple and intuitive API

Key Features

✅ Redis Protocol Compatible - Works with existing Redis clients
✅ Performant - Written in Go for high concurrency and speed
✅ Comprehensive Data Structure Support:

• Key-value strings
• Lists for queue/stack operations
• Sets for unique collections
• Hashes for structured data
• Sorted sets for priority queues

✅ Key Expiration - TTL support for automatic cache invalidation
✅ Atomic Operations - Increment/decrement and other atomic commands
✅ Key Watching - Monitor changes for transaction safety

Architecture

Gedis follows a simple client-server architecture:

The server handles connections using Go's concurrency primitives, with each client connection processed in its own goroutine. Commands are parsed using the RESP protocol implementation and executed against the in-memory data store.

Installation

Prerequisites

• Go 1.24+

From Source

# Clone the repository
git clone https://github.com/GedisCaching/Gedis.git
cd Gedis

# Build and run
make run

Quick Start

Connect with Gedis CLI

- Start the server
- telnet 127.0.0.1 7000

Basic Operations

VID_20250425050040.1.mp4

---

Using with a Go Application

package main

import (
  gedis "github.com/GedisCaching/Gedis/gedis"
)

func main() {
  GedisClient, err := gedis.NewGedis(gedis.Config{
    Address:  Address,
    Password: Password,
  })
}

Command Reference

Gedis supports a subset of Redis commands, organized by data type:

String Operations

• GET key - Get the value of a key
• SET key value - Set the value of a key
• GETDEL key - Get the value and delete the key
• DEL key - Delete a key

Key Management

• KEYS - Get all keys in the database
• TTL key - Get the time to live of a key
• EXPIRE key seconds - Set the expiration time of a key
• RENAME oldkey newkey - Rename a key

List Operations

• LPUSH key value [value ...] - Add values to the head of a list
• RPUSH key value [value ...] - Add values to the tail of a list
• LPOP key - Remove and get the first element of a list
• RPOP key - Remove and get the last element of a list
• LLEN key - Get the length of a list
• LRANGE key start stop - Get elements from a list
• LSET key index value - Set the value of an element in a list by its index

Hash Operations

• HSET key field value - Set the value of a hash field
• HGET key field - Get the value of a hash field
• HDEL key field [field ...] - Delete fields from a hash
• HGETALL key - Get all fields and values from a hash
• HKEYS key - Get all field names in a hash
• HVALS key - Get all values in a hash
• HLEN key - Get the number of fields in a hash

Sorted Set Operations

• ZADD key score member - Add members to a sorted set
• ZRANGE key start stop [WITHSCORES] - Get elements from a sorted set
• ZRANK key member - Get the rank of a member in a sorted set

Numeric Operations

• INCR key - Increment the value of a key
• DECR key - Decrement the value of a key

Contributing

Contributions are welcome! To contribute:

1. Fork the repository
2. Create your feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add some amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

License

This project is open source and available under the MIT License.

---

Client-Project

Gedis-Client is a Go-based client for interacting with the Gedis caching server, a Redis-like in-memory data store. This client provides a simple and intuitive way to interact with Gedis server, allowing you to perform various operations like basic key-value operations, list operations, hash operations, sorted sets, and more.