Skip to content

Commit

Permalink
docs: Update README.md (#212)
Browse files Browse the repository at this point in the history
  • Loading branch information
Yuval-Ariel authored and udi-speedb committed Nov 12, 2023
1 parent 8ea2ab2 commit e50bdc3
Show file tree
Hide file tree
Showing 5 changed files with 29 additions and 10 deletions.
Binary file added .github/new-bee-mascot-dark.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .github/new-bee-mascot.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed .github/speedb-bee-dark.gif
Binary file not shown.
Binary file removed .github/speedb-bee.gif
Binary file not shown.
39 changes: 29 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,12 +14,15 @@
</div>

# Speedb
Speedb is a library that provides persistent key-value stores. Keys and values are arbitrary byte arrays. The keys are ordered within the key value store according to a user-specified comparator function.
Speedb is a library that provides a high performance, persistent key-value store.
This is a community led project that focuses on high performance, optimized for modern storage hardware, on-premise and in the cloud.
It is maintained by Speedb and is forked from Rocksdb, developed by Facebook.

**Jois us to build the next generation data engine!**

<picture>
<source media="(prefers-color-scheme: dark)" srcset=".github/speedb-bee-dark.gif" width="80px" >
<img src=".github/speedb-bee.gif" width="80px">
<source media="(prefers-color-scheme: dark)" srcset=".github/new-bee-mascot-dark.gif" width="80px" >
<img src=".github/new-bee-mascot.gif" width="80px">
</picture>


Expand Down Expand Up @@ -50,21 +53,21 @@ Please refer to the file [INSTALL.md](INSTALL.md) for a list of all the
dependencies and how to install them across different platforms.


## Building Speedb
## 🔨 Building Speedb

Debug:

mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Debug [cmake options]
make rocksdb
make speedb

By default the build type is Debug.

Release:

mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release [cmake options]
make rocksdb
make speedb

This will build the static library. If you want to build the dynamic library,
use:
Expand All @@ -82,14 +85,30 @@ For development and functional testing, go with the debug version which includes
more assertions and debug prints. Otherwise, for production or performance
testing, we recommend building a release version which is more optimized.

## 📈 Performance

We are using DBbench to test performance and progress between the versions. It is available under tools and also in the artifact for direct download.
In there you can also find a readme with the commands we are using to get you started.
Here is a graph comparing Speedb's paired bloom filter with the default bloom filter. 


<img width="769" alt="Screen Shot 2022-10-31 at 15 15 42" src="https://user-images.githubusercontent.com/107058910/199016617-4ecbe279-b281-4a8c-b630-87a509bc09da.png">


For additional info see: <a href="https://app.gitbook.com/o/o2rbZPVFSai2q6o8Il3m/s/9jcjg12ODKbmmsnY7Cma/speedb-features/paired-bloom-filter">Paired Bloom Filter</a>

## 🛣️ Roadmap
The <a href="https://github.com/orgs/speedb-io/projects/4/views/1"> product roadmap</a> provides a snapshot of the features we are currently developing, what we are planning for the future, and the items that have already been delivered.

We have added a column with items that are awaiting community feedback. We invite you to participate in our polls inside, share your thoughts about topics that are important to you, and let us know if there is anything else you would like to see on the list.

## Questions
## Questions

- For live discussion with the community you can use our official [Discord channel](https://discord.gg/52yzKZ5G9D).
- For technical questions and discussions you can use our official [Discourse forum](https://speedb.discourse.group/).
- For live discussion with the community you can use our official [Discord channel](https://discord.gg/5fVUUtM2cG).
- For technical questions and discussions you can use our official [Discourse forum](https://forum.speedb.dev).


## Join us
## 🌎 Join us

Speedb is committed to a welcoming and inclusive environment where everyone can
contribute.
Expand Down

0 comments on commit e50bdc3

Please sign in to comment.