lykiadb

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 34 Open GitHub ↗

A toy document DB mainly created for self-education and fun

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# λykiaDB
<div style="display: flex;">
<div>

[![CI](https://github.com/lykia-rs/lykiadb/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/lykia-rs/lykiadb/actions/workflows/ci.yml)

</div>
<div>

[![codecov](https://codecov.io/gh/lykia-rs/lykiadb/graph/badge.svg?token=DGIK7BE3K1)](https://codecov.io/gh/lykia-rs/lykiadb)

</div>
</div>

Lykia is a document database management system built for educational purposes. The famous book, Crafting Interpreters, was the main source of inspiration for the project. It turned into a database, though.

## Overview
- 100% safe Rust, #BlazinglyFast
- A weird scripting and query language, combination of JavaScript and SQL. The language is a separate module thus can be used without the database.
- A subset of JSON data types in both scripting language itself and storage
- In-disk and in-memory storage
- ACID compliance
- Replication

## Primary goals
- [x] Core scripting language + DML/DDL SQL
- [x] Client and server apps
- [x] A minimal standard library
- [ ] Query planning and binding (in progress)
- [ ] Query execution (in progress)
- [ ] Persistent storage engine (in progress)
- [ ] Transactions and multi-version concurrency control

## Phase 2 goals
- [ ] Replication with Raft
- [ ] JIT execution for expression evaluation
- [ ] Query optimization
    
## Non-goals
- LykiaDB is not (and will not be) a production-grade database.

## Getting Started
To use Lykia, you can download the latest release from the GitHub releases page.

Developing via client:

```shell
cargo run-script dev-client
```

Run the server:

```shell
$ cargo run --release --bin lykiadb-server
```
Run the shell:

```shell 
$ cargo run --release --bin lykiadb-shell lykiadb-shell/examples/fib.ly
```

Flamegraph a benchmark:

```shell
$ sudo cargo flamegraph --bench interpreter -- --bench
```

For playground, please visit [lykia-rs/playground](https://github.com/lykia-rs/playground)

## License
Lykia is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.

lykiadb

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README