QuickSilver is an open-source high-performance, in-memory key-value store with sharding, persistence, and multi-threaded client handling.
Designed for speed, scalability, and flexibility, it supports multiple database backends (InMemoryDB, ShardedDB), and persists data to disk.
✅ In-Memory Storage – Fast key-value operations
✅ Sharding Support – Distributes data across multiple instances
✅ LRU Eviction – Removes least-recently used entries when full
✅ Persistence – Saves and loads data from disk
✅ Multi-threaded – Uses a thread pool for efficient client handling
✅ Command Pattern – Extensible command execution
✅ Cluster Support – Distribute data across multiple nodes
📦 quicksilver
├── 📂 src
│ ├── 📂 main
│ │ ├── 📂 io.github.udayhe.quicksilver
│ │ │ ├── 📂 client
│ │ │ │ ├── ClientHandler.java # Handles client connections
│ │ │ ├── 📂 cluster
│ │ │ │ ├── ClusterClient.java # Sends commands to cluster nodes
│ │ │ │ ├── ClusterManager.java # Manages Cluster nodes
│ │ │ │ ├── ClusterNode.java # Cluster node
│ │ │ │ ├── ClusterService.java # Serves the cluster
│ │ │ │ ├── ConsistentHashing.java # ConsistentHashing
│ │ │ ├── 📂 command
│ │ │ │ ├── 📂 implementation
│ │ │ │ │ ├── Del.java # DELETE command
│ │ │ │ │ ├── Exit.java # EXIT command
│ │ │ │ │ ├── Flush.java # FLUSH command
│ │ │ │ │ ├── Get.java # GET command
│ │ │ │ │ ├── Set.java # SET command
│ │ │ │ ├── Command.java # Command interface
│ │ │ │ ├── CommandRegistry.java # Manages command execution
│ │ │ ├── 📂 config
│ │ │ │ ├── Config.java # Reads and manages configuration
│ │ │ ├── 📂 constant
│ │ │ │ ├── Constants.java # Application-wide constants
│ │ │ ├── 📂 db
│ │ │ │ ├── 📂 implementation
│ │ │ │ │ ├── InMemoryDB.java # In-memory key-value store
│ │ │ │ │ ├── ShardedDB.java # Sharded database implementation
│ │ │ │ ├── DatabaseFactory.java # Factory to create DB instances
│ │ │ │ ├── DB.java # Generic database interface
│ │ │ ├── 📂 enums
│ │ │ │ ├── Command.java # Enum for commands
│ │ │ │ ├── DBType.java # Enum for database types
│ │ │ ├── 📂 threads
│ │ │ │ ├── ThreadPoolManager.java # Centralized thread pool manager
│ │ │ ├── 📂 util
│ │ │ │ ├── ClusterUtil.java # Cluster related utility methods
│ │ │ │ ├── Util.java # Utility class
│ │ │ ├── Server.java # Main server entry point
│ │ ├── 📂 resources
│ │ │ ├── config.properties # Configurations (port, shards, etc.)
├── 📂 test # Unit tests
├── 📜 .gitignore # Git ignore rules
├── 📜 build.gradle # Gradle build file
├── 📜 Dockerfile # Docker configuration
├── 📜 gradlew # Gradle wrapper
├── 📜 LICENSE # License file
├── 📜 README.md # Project documentation
├── 📜 settings.gradle # Gradle settings
📦 1. Clone the Repository
git clone https://github.com/UdayHE/Quicksilver.git
cd Quicksilver🔧 2. Build the Project
./gradlew build⚡ 3. Run the Server
java -jar build/libs/Quicksilver-1.0-SNAPSHOT.jar🔌 4. Default Port: 6379
Set custom port:
java -jar build/libs/Quicksilver-1.0-SNAPSHOT.jar 7000Modify config.properties in src/main/resources/:
server.port=7000
db.type=SHARDED
shard.count=4
shard.size=100
| Command | Description | Examle |
|---|---|---|
SET key value |
Stores a value | SET username uday |
GET key |
Retrieves a value | GET username |
DEL key |
Deletes a key | DEL username |
FLUSH |
Clears all data | FLUSH |
EXIT |
Closes the connection | EXIT |
Apache License Version 2.0
https://github.com/UdayHE/Quicksilver/blob/master/LICENSE