< html >
< div align = "center" >
< img src = "https://raw.githubusercontent.com/terrabasedb/docs/master/docs/assets/img/favicon.ico" height = 64 width = 64 style = "float:left" >
< h1 > Terrabase< b > DB< / b > < / h1 > < h3 > The next-generation NoSQL database< / h3 >
    
[](https://hub.docker.com/r/terrabasedb/tdb)
[](https://git.io/JJZ8Z)
< / div >
< / html >
## What is TerrabaseDB?
TerrabaseDB (or TDB for short) is an effort to provide the best of key/value stores, document stores and columnar databases, that is, **simplicity, flexibility and queryability at scale** . TDB is curently in an alpha stage, but can be used as a **performant** and **persistent key-value store** .
## Getting started 🚀
1. Download a bundle for your platform from [here ⬇️ ](https://github.com/terrabasedb/terrabase/releases )
2. Unzip the bundle
3. Make the files executable (run `chmod +x tdb tsh` on *nix systems)
4. First run `tdb` to start the database server and then run `tsh` to start the interactive shell
5. Run commands like: `SET foo bar` , `GET bar` , `UPDATE cat mitten` or `DEL proprietary` 🤪 on `tsh` !
## Actions
* `HEYA` - It all begins with a heya! Use this to ping the server
* `GET` / `MGET` - Get a single/multiple key(s)
* `SET` / `MSET` - Set a single/multiple key(s)
* `UPDATE` / `MUPDATE` - Update the value of a single/multiple key(s) which has already been created with `SET`
* `EXISTS` - Check if a single/multiple key(s) exist(s)
* `DEL` - Delete a single/multiple key(s)
And, a lot more actions are coming soon!
## Clients 🔌
We're officially working on a [Python Driver ](https://github.com/terrabasedb/python-driver ) and we plan to support more languages along the way 🎉! You're free to write your own clients - all you need to do is implement the simple and performant [Terrapipe protocol spec ](https://git.io/JJZ4Z ).
## Community 👐
A project which is powered by the community believes in the power of community! If you get stuck anywhere - here are your options!
< html >
< a href = "https://gitter.im/terrabasehq/community" > < img src = "https://img.shields.io/badge/chat%20on-gitter-ed1965?logo=gitter&style=flat-square" > < / img >
< / a >
< a href = "https://join.slack.com/t/terrabasedb/shared_invite/zt-fnkfgzf7-~WO~RzGUUvTiYV4iPAMiiQ" > < img src = "https://img.shields.io/badge/discuss%20on-slack-4A154B?logo=slack&style=flat-square" > < / img >
< / a > < a href = "https://discord.gg/QptWFdx" > < img src = "https://img.shields.io/badge/talk-on%20discord-7289DA?logo=discord&style=flat-square" > < / img > < / a >
< / html >
## Platforms 💻
  
## Versioning
This project strictly follows semver, however, since this project is currently in the development phase (0.x.y), the API may change unpredictably
## Contributing
**Yes - we need you!** Be it a typo, a bizarre idea, a dirty bug🐞 or an amazing patch - you're welcome to contribute to TDB! Beginner friendly issues are marked with the [<img src=https://img.shields.io/badge/L--easy-C71585> ](https://github.com/terrabasedb/terrabasedb/labels/L-easy ) label. Read the guide [here ](./CONTRIBUTING.md ).
## License
This project is licensed under the [AGPL-3.0 License ](./LICENSE ).
