Skip to content

(docs): Improve README file for Navi #550

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Apr 4, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 8 additions & 6 deletions navi/navi/README.md → navi/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Navi: High-Performance Machine Learning Serving Server in Rust

Navi is a high-performance, versatile machine learning serving server implemented in Rust, tailored for production usage. It's designed to efficiently serve within the Twitter tech stack, offering top-notch performance while focusing on core features.
Navi is a high-performance, versatile machine learning serving server implemented in Rust and tailored for production usage. It's designed to efficiently serve within the Twitter tech stack, offering top-notch performance while focusing on core features.

## Key Features

Expand All @@ -23,12 +23,14 @@ While Navi's features may not be as comprehensive as its open-source counterpart
- `thrift_bpr_adapter`: generated thrift code for BatchPredictionRequest

## Content
We include all *.rs source code that makes up the main navi binaries for you to examine. The test and benchmark code, as well as configuration files are not included due to data security concerns.
We have included all *.rs source code files that make up the main Navi binaries for you to examine. However, we have not included the test and benchmark code, as well as various configuration files, due to data security concerns.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"as well as" implies conjunction with a positive statement. The correct verbiage here would probably be "or":

However, we have not included the test and benchmark code, or various configuration files, due to data security concerns.

I would also recommend dropping the "the":

However, we have not included test and benchmark code, or various configuration files, due to data security concerns.

The comma between "code" and "or", and "files" and "due", has a panache that draws attention from the next clause. An em dash might be necessary here.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

agree. will fix in original code and propogate to the open source version.


## Run
in navi/navi you can run. Note you need to create a models directory and create some versions, preferably using epoch time, e.g., 1679693908377
- scripts/run_tf2.sh
- scripts/run_onnx.sh
In navi/navi, you can run the following commands:
- `scripts/run_tf2.sh` for [TensorFlow](https://www.tensorflow.org/)
- `scripts/run_onnx.sh` for [Onnx](https://onnx.ai/)

Do note that you need to create a models directory and create some versions, preferably using epoch time, e.g., `1679693908377`.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note should be placed before shell files.


## Build
you can adapt the above scripts to build using Cargo
You can adapt the above scripts to build using Cargo.