A high-performance, lightweight key-value store server written in Zig, supporting both TCP and Unix socket interfaces.

• Dual Interface: Simultaneous TCP and Unix socket support

• High Performance: Built with Zig for maximum efficiency

• Simple Protocol: Easy-to-use text-based protocol

• Thread-Safe: Concurrent client handling

• Memory Safe: No garbage collector, manual memory management

Zig Build version: 0.15.1+

Using Homebrew

brew tap mailmug/zentropy
brew install mailmug/zentropy/[email protected]

Start service

brew services start [email protected]

Step 1: Download the release binary

Step 2: Extract the ZIP file.

Step 3: Copy the zentropy.conf file, edit the password, and place it in the same directory as the zentropy binary:

bind_address 127.0.0.1
port 6383
password pass@123

Step 4: Run the binary based on your CPU architecture:

./zentropy --config path/to/zentropy.conf

✅ Tip: Once the server is running, you can test it using the Python Client:

from zentropy import Client

client = Client(password="pass@123")
print(client.ping())  # Should print: True

1. Python Client Library.
2. PHP Client Library.

nc 127.0.0.1 6383
PING
# -> +PONG

SET apple red
# -> +OK

GET apple
# -> $3
# -> red

DELETE apple
# -> :1

echo "PING" | nc -U /tmp/zentropy.sock
# -> +PONG

Roadmap

Zentropy is open-source! Contributions, suggestions, and bug reports are welcome.

Feel free to fork the repo, submit PRs, or open issues.