Metadata-Version: 2.1
Name: ryugraph
Version: 25.9.0
Summary: Highly scalable, extremely fast, easy-to-use embeddable graph database
Home-page: https://github.com/predictable-labs/ryugraph
License: MIT
Project-URL: Homepage, https://ryugraph.com/
Project-URL: Documentation, https://docs.ryugraph.com/
Project-URL: Repository, https://github.com/ryugraph/ryu
Project-URL: Changelog, https://github.com/ryugraph/ryu/releases
Keywords: graph,database
Description-Content-Type: text/markdown
License-File: LICENSE

# Ryu
Ryu, a fork of Kuzu, is an embedded graph database built for query speed and scalability. Ryu is optimized for handling complex analytical workloads 
on very large databases and provides a set of retrieval features, such as a full text search and vector indices. Our core feature set includes:

- Flexible Property Graph Data Model and Cypher query language
- Embeddable, serverless integration into applications
- Native full text search and vector index
- Columnar disk-based storage
- Columnar sparse row-based (CSR) adjacency list/join indices
- Vectorized and factorized query processor
- Novel and very fast join algorithms
- Multi-core query parallelism
- Serializable ACID transactions
- Wasm (WebAssembly) bindings for fast, secure execution in the browser

Ryu was initially developed by Kuzu Inc. Now it's maintained by Predictable Labs under the name of Ryu. It is available under a permissible license.

## Docs and Blog

To learn more about Ryu, see our [Documentation](https://ryugraph.github.io/docs) and [Blog](https://ryugraph.github.io/blog) page.

## Getting Started

Refer to our [Getting Started](https://ryugraph.github.io/docs/get-started/) page for your first example.

## Extensions
Ryu has an extension framework that users can dynamically load the functionality you need at runtime.
We've developed a list of [official extensions](https://ryugraph.github.io/docs/extensions/#available-extensions) that you can use to extend Ryu's functionality.

Ryu requires you to install the extension before loading and using it.
Note that Ryu no longer provides the official extension server, where you can directly install any official extensions.

If you've upgraded to the latest version v0.11.3, Ryu has pre-installed four commonly used extensions (`algo`, `fts`, `json`, `vector`) for you.
You do not need to manually INSTALL these extensions.

For Ryu versions before v0.11.3, or to install extensions that haven't been pre-installed, you have to set up a local extension server.
The instructions of setting up a local extension server can be found below.

### Host your own extension server

The extension server is based on NGINX and is hosted on [GitHub](https://ghcr.io/ryugraph/extension-repo). You can pull the Docker image and run it in your environment:

```bash
docker pull ghcr.io/ryugraph/extension-repo:latest
docker run -d -p 8080:80 ghcr.io/ryugraph/extension-repo:latest
```

In this example, the extension server will be available at `http://localhost:8080`. You can then install extensions from your server by appending the `FROM` clause to the `INSTALL` command:

```cypher
INSTALL <EXTENSION_NAME> FROM 'http://localhost:8080/';
```

## Build from Source

You can build from source using the instructions provided in the [developer guide](https://ryugraph.github.io/docs/developer-guide).

## License
Ryu is licensed under the [MIT License](LICENSE).
