mirror of
https://github.com/lancedb/lancedb.git
synced 2026-01-10 13:52:58 +00:00
e50b642d80
Changes: * Refactors the Node module to load the shared library from a separate package. When a user does `npm install vectordb`, the correct optional dependency is automatically downloaded by npm. * Brings Rust and Node versions in alignment at 0.1.2. * Add scripts and instructions to build Linux and MacOS node artifacts locally. * Add instructions for publishing the npm module and crates.
64 lines
1.1 KiB
Markdown
64 lines
1.1 KiB
Markdown
# LanceDB
|
|
|
|
A JavaScript / Node.js library for [LanceDB](https://github.com/lancedb/lancedb).
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
npm install vectordb
|
|
```
|
|
|
|
This will download the appropriate native library for your platform. We currently
|
|
support x86_64 Linux, aarch64 Linux, Intel MacOS, and ARM (M1/M2) MacOS. We do not
|
|
yet support Windows or musl-based Linux (such as Alpine Linux).
|
|
|
|
## Usage
|
|
|
|
### Basic Example
|
|
|
|
```javascript
|
|
const lancedb = require('vectordb');
|
|
const db = lancedb.connect('<PATH_TO_LANCEDB_DATASET>');
|
|
const table = await db.openTable('my_table');
|
|
const query = await table.search([0.1, 0.3]).setLimit(20).execute();
|
|
console.log(results);
|
|
```
|
|
|
|
The [examples](./examples) folder contains complete examples.
|
|
|
|
## Development
|
|
|
|
To build everything fresh:
|
|
|
|
```bash
|
|
npm install
|
|
npm run tsc
|
|
npm run build
|
|
```
|
|
|
|
Then you should be able to run the tests with:
|
|
|
|
```bash
|
|
npm test
|
|
```
|
|
|
|
### Rebuilding Rust library
|
|
|
|
```bash
|
|
npm run build
|
|
```
|
|
|
|
### Rebuilding Typescript
|
|
|
|
```bash
|
|
npm run tsc
|
|
```
|
|
|
|
### Fix lints
|
|
|
|
To run the linter and have it automatically fix all errors
|
|
|
|
```bash
|
|
npm run lint -- --fix
|
|
```
|