# ella
[](https://crates.io/crates/ella/)
[](https://docs.rs/ella/)

## Getting Started
Add `ella` to your `Cargo.toml` file:
```toml
ella = "0.1.4"
```
You may also want to install the [ella CLI tools](https://crates.io/crates/ella-cli/).
### Windows
Building `ella` on Windows requires the Protobuf compiler to be installed.
[You can download a pre-built binary from the Protobuf repo.](https://github.com/protocolbuffers/protobuf/releases)
## Usage
You can access ella by either starting a new instance or connecting to an existing instance.
Start a new instance by opening or creating a datastore:
```rust
let el = ella::open("file:///path/to/db")
.or_create(ella::Config::default())
.and_serve("localhost:50052")?
.await?;
```
Connect to an existing instance using `ella::connect`:
```rust
let el = ella::connect("http://localhost:50052").await?;
```