kividb README

README проекта с github.com/kividbio/kividb. Одним файлом markdown: README.md.

KiviDB: the in-memory database for AI and real-time apps. Redis-compatible, vector search built in.

English · 简体中文

CI Latest release Docker pulls Artifact Hub License: AGPL-3.0 Discussions Discord

kividbio%2Fkividb | Trendshift Hacker News

KiviDB is a fast, multi-threaded alternative to Redis® and Valkey, written in Rust. It speaks the Redis protocol (RESP2 and RESP3), so existing Redis clients, redis-cli and libraries work unchanged, and it has full-text and vector search built in. It runs every core on a sharded in-memory key-value design, and persists to snapshots and an optional append-only file.

On 32 cores of AWS bare metal, KiviDB 1.2.0 serves 21.2 million pipelined GETs per second: 9× Redis 8.10 and 2.3× Dragonfly, ahead of Garnet, at 0.36 ms p99 (benchmarks).

Install

Debian and Ubuntu (apt)

sudo apt update && sudo apt install -y ca-certificates curl
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://packages.kividb.io/kividb.gpg | sudo tee /etc/apt/keyrings/kividb.gpg > /dev/null
echo "deb [signed-by=/etc/apt/keyrings/kividb.gpg] https://packages.kividb.io/deb stable main" \
  | sudo tee /etc/apt/sources.list.d/kividb.list > /dev/null
sudo apt update && sudo apt install -y kividb

Fedora, RHEL and compatibles, Amazon Linux 2023 (dnf)

sudo curl -fsSL -o /etc/yum.repos.d/kividb.repo https://packages.kividb.io/kividb.repo
sudo dnf install -y kividb

macOS, Cargo and Docker

brew install kividbio/tap/kividb                  # macOS (Homebrew)
cargo install --locked kividb                     # Linux and macOS, from crates.io
docker run -d -p 6380:6380 -v kividb-data:/home/kividb kividb/kividb:v1.2.2

Docker images are on Docker Hub and the GitHub Container Registry (ghcr.io/kividbio/kividb), tagged v1.2.2, 1.2 and latest; they are distroless (no shell). The data lives in /home/kividb: without a volume there, it is lost when the container is removed or recreated.

The apt and dnf repositories are signed with the key 6492 17DE 0F7F D7DB 3D7B AC3A E21D 8F6E DDE5 F489; check it before you install. docs/INSTALL.md has how to check it, what the packages install, upgrades and pinning, the Lua and TLS variants, the release tarballs and .deb/.rpm files on GitHub Releases, and how to verify a download. To build it yourself, see docs/BUILDING.md.

Quick start

The apt and dnf packages start KiviDB as a systemd service, on 127.0.0.1:6380. Otherwise, start it yourself:

kividb                                   # listens on 0.0.0.0:6380
redis-cli -p 6380 PING                   # PONG
redis-cli -p 6380 SET greeting hello     # OK
redis-cli -p 6380 GET greeting           # "hello"

KiviDB listens on 6380, not Redis's 6379, so the two can run side by side; point your client at that port, or pass --port 6379. Protected mode is on by default: until you set a password or a bind address, only clients on the same machine may connect. docs/CONFIGURATION.md lists the flags and the configuration file, TLS, logs and the startup update check.

Performance

KiviDB 1.2.0 against Garnet, Dragonfly, Redis, Redis Cluster and Valkey: throughput, latency, MSET, memory, snapshots and vector search

KiviDB 1.2.0 against Garnet, Dragonfly, Redis, Redis Cluster and Valkey. Click for the full-resolution video.

docs/PERFORMANCE.md has the bare-metal table and method, the full suite on Azure VMs, where KiviDB loses, earlier runs and independent reviews.

Features

Documentation

Installing · Building from source · Running and configuring · Persistence · Migrating from Redis · Compatibility and differences · Commands · Client examples · Vector search · Performance · Logs and errors · FAQ · Changelog · Releases · Website: kividb.io

Contributing

Contributions are welcome. See CONTRIBUTING.md for how to build, test and submit changes. Contributions are accepted under the Contributor License Agreement, which you sign on your first pull request.

Questions, ideas, or want to talk to the maintainers? Join us on Discord, or open a discussion.

Please follow the Code of Conduct. The Changelog lists what changed in each release.

Security

Please do not report security vulnerabilities in public issues. See SECURITY.md for how to report one privately.

License

Copyright (c) 2026 KIVIDB PRIVATE LIMITED.

KiviDB is open source software, licensed under the GNU Affero General Public License, version 3 (AGPL-3.0-only), an OSI-approved license. You may use, modify and redistribute it under its terms. See NOTICE.

Using KiviDB does not put your application under the AGPL. An application that talks to KiviDB over the network, through any Redis client, is a separate program: you can run an unmodified KiviDB as your database, in any product, open or closed, commercial or not, with no obligation on your application's code. The AGPL asks for one thing beyond the GPL: if you modify KiviDB itself and let others use your modified version over a network (for example, as a hosted service), you must offer them the source code of your modified KiviDB.

Commercial license. KIVIDB PRIVATE LIMITED owns the copyright in KiviDB and also offers it under a commercial license, for organizations that cannot use AGPL software or that want to modify or embed KiviDB without publishing their changes. Write to [email protected].

Our commitment. Every version of KiviDB we release under the AGPLv3 stays available under the AGPLv3. The Contributor License Agreement lets us offer the commercial license alongside it; it is not a way to take the open source version away.

Questions about the license are answered in the FAQ.

Trademarks

Redis® is a registered trademark of Redis Ltd. Any rights therein are reserved to Redis Ltd. Any use by KiviDB is for referential purposes only and does not indicate any sponsorship, endorsement or affiliation between Redis and KiviDB. KiviDB is not affiliated with Redis Ltd. Other names mentioned are trademarks of their respective owners.

kividb (kividbio/kividb)

Ищем в базе…

1.2K ·GitHub
Что это такое?KiviDB — это быстрая многопоточная альтернатива Redis и Valkey, написанная на Rust. Она поддерживает протокол Redis (RESP2/RESP3), поэтому существующие Redis-клиенты работают без изменений, а полнотекстовый и векторный поиск встроены прямо в неё.
Это полная замена, или нужен особый клиент?Это полная замена: KiviDB реализует сетевой протокол Redis, поэтому redis-cli и любая существующая клиентская библиотека для Redis работают с ней без изменений, только порт по умолчанию другой — 6380 вместо 6379.
Как это запустить?Запустите опубликованный Docker-образ, скачайте бинарный файл релиза для Linux (x86_64/aarch64) или macOS (Apple Silicon/Intel) со страницы GitHub Releases либо соберите из исходников с помощью Cargo. По умолчанию сервер слушает порт 6380, так что направьте на него любой Redis-клиент.
Какие подводные камни учесть, прежде чем направлять на неё реальный трафик?По умолчанию она принимает только подключения с локального адреса, пока вы не задали пароль или адрес привязки (защищённый режим), поэтому публичный доступ без пароля оставит её открытой для интернета. Кроме того, io_uring часто блокируется стандартным профилем seccomp в Docker, и тогда он молча переключается на Tokio, а команды скриптов Lua выдают ошибку, если не собрать сервер с функцией lua.
В чём подвох с лицензией AGPL?KiviDB распространяется под лицензией AGPL-3.0-only, но в README прямо сказано, что использование KiviDB в качестве клиента не распространяет действие AGPL на ваше собственное приложение.
Насколько она быстрее Redis на практике?В собственном бенчмарке проекта за октябрь 2026 года на AWS Graviton3 KiviDB обработала около 21 миллиона GET-запросов в секунду с конвейеризацией против 2,4 млн у Redis 8 и 9,1 млн у Dragonfly, при этом её задержка p99 была меньше половины задержки Dragonfly. В README предупреждается, что это результат одного контролируемого замера, а не гарантия для вашей нагрузки.
Можно ли запускать векторный и полнотекстовый поиск, как в Redis Stack?Да, KiviDB реализует команды FT.* в стиле Redis Stack (FT.CREATE, FT.SEARCH, FT.HYBRID) для полнотекстового поиска BM25, фильтров по тегам и числам, а также приближённого векторного поиска (ANN) с индексами FLAT или HNSW по полям хэшей, так что существующие руководства и бинарные векторные данные в основном работают без изменений.
Что происходит с моими данными при перезапуске?KiviDB сохраняет данные в собственные снимки (dump.kdb), которые включают каждый векторный граф HNSW, а также необязательный журнал только для добавления (AOF), который воспроизводится при запуске. Поэтому при использовании --aof авария потеряет не более примерно одной секунды записей.
Почему сервер слушает порт 6380, а не 6379, как у Redis?Чтобы экземпляр KiviDB мог работать рядом с настоящим экземпляром Redis или Valkey на той же машине без конфликта портов; если хотите изменить порт, передайте --port 6379.
Какие есть похожие проекты?dragonfly, phpredis, redis, valkey, dicedb, pgrust, garnet, memcached
Автор
kividbio
Размер
108.9 MB
Звёзды
1.2K
Возраст
1 мес
Коммиты · 90 дней