{"id":20018309,"url":"https://github.com/valkey-io/valkey-bloom","last_synced_at":"2026-02-24T08:27:04.472Z","repository":{"id":236381118,"uuid":"792497562","full_name":"valkey-io/valkey-bloom","owner":"valkey-io","description":"Rust based Valkey Module which provides BloomFilter APIs and implements its data type","archived":false,"fork":false,"pushed_at":"2025-04-01T22:23:42.000Z","size":240,"stargazers_count":15,"open_issues_count":0,"forks_count":10,"subscribers_count":4,"default_branch":"unstable","last_synced_at":"2025-04-08T13:53:38.270Z","etag":null,"topics":["probabilistic","rust","valkey"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/valkey-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-04-26T19:45:42.000Z","updated_at":"2025-03-31T22:05:54.000Z","dependencies_parsed_at":"2024-08-26T06:51:24.555Z","dependency_job_id":"d6de9f99-68ba-48de-b47f-bd00db638257","html_url":"https://github.com/valkey-io/valkey-bloom","commit_stats":null,"previous_names":["karthiksubbarao/valkey-bloom"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valkey-io%2Fvalkey-bloom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valkey-io%2Fvalkey-bloom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valkey-io%2Fvalkey-bloom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valkey-io%2Fvalkey-bloom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/valkey-io","download_url":"https://codeload.github.com/valkey-io/valkey-bloom/tar.gz/refs/heads/unstable","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252414179,"owners_count":21744056,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["probabilistic","rust","valkey"],"created_at":"2024-11-13T08:21:19.812Z","updated_at":"2026-02-24T08:27:04.392Z","avatar_url":"https://github.com/valkey-io.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# valkey-bloom\n\nValkey-Bloom (BSD-3-Clause) is a Rust Valkey-Module which brings a native and space efficient probabilistic Module data type to Valkey. With this, users can create filters (space-efficient probabilistic Module data type) to add elements, perform “check” operation to test whether an element exists, auto scale their filters, perform RDB Save and load operations, etc.\n\nValkey-Bloom is built using bloomfilter::Bloom (https://crates.io/crates/bloomfilter which has a BSD-2-Clause license).\n\nIt is compatible with the BloomFilter (BF.*) command APIs of the ReBloom Module from Redis Ltd.\n\nThe following commands are supported.\n```\nBF.EXISTS\nBF.ADD\nBF.MEXISTS\nBF.MADD\nBF.CARD\nBF.RESERVE\nBF.INFO\nBF.INSERT\n```\n\nBuild instructions for Linux.\n```\ncurl https://sh.rustup.rs -sSf | sh\nsudo yum install clang\ngit clone https://github.com/KarthikSubbarao/valkey-bloom.git\ncd valkey-bloom\ncargo build --all --all-targets  --release\nvalkey-server --loadmodule ./target/release/libvalkey_bloom.so\n```\n\nLocal development script to build, run format checks, run unit / integration tests, and for cargo release:\n```\n# Builds the valkey-server (unstable) for integration testing.\nSERVER_VERSION=unstable\n./build.sh\n# Builds the valkey-server (8.0.0) for integration testing.\nSERVER_VERSION=8.0.0\n./build.sh\n```\n\nClient Usage\n```\n\u003credacted\u003e % ./valkey-cli \n127.0.0.1:6379\u003e module list\n1) 1) \"name\"\n   2) \"bloom\"\n   3) \"ver\"\n   4) (integer) 1\n   5) \"path\"\n   6) \"./target/release/libvalkey_bloom.so\"\n   7) \"args\"\n   8) (empty array)\n127.0.0.1:6379\u003e bf.add key item\n(integer) 1\n127.0.0.1:6379\u003e bf.exists key item\n(integer) 1\n127.0.0.1:6379\u003e bf.exists key item2\n(integer) 0\n127.0.0.1:6379\u003e bf.card key\n(integer) 1\n127.0.0.1:6379\u003e bf.reserve key 0.01 10000\n(error) ERR item exists\n127.0.0.1:6379\u003e bf.reserve key1 0.01 10000\nOK\n127.0.0.1:6379\u003e bf.card key1\n(integer) 0\n127.0.0.1:6379\u003e bf.add key1 item\n(integer) 1\n127.0.0.1:6379\u003e bf.card key1\n(integer) 1\n```\n\n```\n127.0.0.1:6379\u003e bf.reserve key1 0.01 10000\nOK\n127.0.0.1:6379\u003e bf.info key3\n(empty array)\n127.0.0.1:6379\u003e bf.info key1\n 1) Capacity\n 2) (integer) 10000\n 3) Size\n 4) (integer) 12198\n 5) Number of filters\n 6) (integer) 1\n 7) Number of items inserted\n 8) (integer) 0\n 9) Expansion rate\n10) (integer) 2\n```\n\nRDB Load, Save and flushall validation\n```\n127.0.0.1:6379\u003e info keyspace\n# Keyspace\n127.0.0.1:6379\u003e bf.add key item\n(integer) 1\n127.0.0.1:6379\u003e info keyspace\n# Keyspace\ndb0:keys=1,expires=0,avg_ttl=0\n127.0.0.1:6379\u003e flushall\nOK\n127.0.0.1:6379\u003e info keyspace\n# Keyspace\n127.0.0.1:6379\u003e bf.add key item\n(integer) 1\n127.0.0.1:6379\u003e bgsave\nBackground saving started\n127.0.0.1:6379\u003e shutdown\nnot connected\u003e info keyspace // Started up\n# Keyspace\ndb0:keys=1,expires=0,avg_ttl=0\n127.0.0.1:6379\u003e keys *\n1) \"key\"\n127.0.0.1:6379\u003e bf.exists key item\n(integer) 1\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalkey-io%2Fvalkey-bloom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvalkey-io%2Fvalkey-bloom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalkey-io%2Fvalkey-bloom/lists"}