improved description of repository, moved CLI info to README.md
This commit is contained in:
18
README.md
18
README.md
@@ -3,28 +3,34 @@
|
|||||||
Embeddingsearch is a DotNet C# library that uses Embedding Similarity Search (similiarly to [Magna](https://github.com/yousef-rafat/Magna/tree/main)) to semantically compare a given input to a database of pre-processed entries.
|
Embeddingsearch is a DotNet C# library that uses Embedding Similarity Search (similiarly to [Magna](https://github.com/yousef-rafat/Magna/tree/main)) to semantically compare a given input to a database of pre-processed entries.
|
||||||
|
|
||||||
This repository comes with
|
This repository comes with
|
||||||
- a server
|
- a server (accessible via API calls)
|
||||||
- a clientside library
|
- a clientside library
|
||||||
- a ready-to-use CLI module
|
- a CLI module
|
||||||
- an API for if you want to process the data on a remote server or make it available to other languages.
|
- an indexer (TBD)
|
||||||
|
|
||||||
(Currently only initial retrieval is implemented.
|
(Currently only initial retrieval is implemented.
|
||||||
Reranker support is planned, but its integration is not yet conceptualized.)
|
Reranker support is planned, but its integration is not yet conceptualized.)
|
||||||
# How to set up
|
# How to set up / use
|
||||||
## server
|
## server
|
||||||
1. Install [ollama](https://ollama.com/download)
|
1. Install [ollama](https://ollama.com/download)
|
||||||
2. Pull a few models using ollama (e.g. `paraphrase-multilingual`, `bge-m3`, `mxbai-embed-large`, `nomic-embed-text`)
|
2. Pull a few models using ollama (e.g. `paraphrase-multilingual`, `bge-m3`, `mxbai-embed-large`, `nomic-embed-text`)
|
||||||
3. [Install the depencencies](docs/Server.md#installing-the-dependencies)
|
3. [Install the depencencies](docs/Server.md#installing-the-dependencies)
|
||||||
4. [Set up a local mysql database](docs/Server.md#mysql-database-setup)
|
4. [Set up a local mysql database](docs/Server.md#mysql-database-setup)
|
||||||
5. (optional) [Create a searchdomain](#create-a-searchdomain)
|
5. (optional) [Create a searchdomain](#create-a-searchdomain)
|
||||||
## indexer
|
|
||||||
TBD
|
|
||||||
## client
|
## client
|
||||||
1. Download the package and add it to your project (TODO: NuGet)
|
1. Download the package and add it to your project (TODO: NuGet)
|
||||||
2. Create a new client by either:
|
2. Create a new client by either:
|
||||||
1. By injecting IConfiguration (e.g. `services.AddSingleton<Client>();`)
|
1. By injecting IConfiguration (e.g. `services.AddSingleton<Client>();`)
|
||||||
2. By specifying the baseUri, apiKey, and searchdomain (e.g. `new Client.Client(baseUri, apiKey, searchdomain)`)
|
2. By specifying the baseUri, apiKey, and searchdomain (e.g. `new Client.Client(baseUri, apiKey, searchdomain)`)
|
||||||
|
## indexer
|
||||||
|
TBD
|
||||||
|
## CLI
|
||||||
|
Before anything follow these steps:
|
||||||
|
1. Enter the project's `src` directory (used as the working directory in all examples)
|
||||||
|
2. Build the project: `dotnet build`
|
||||||
|
All user-defined parameters are denoted using the `$` symbol. I.e. `$mysql_ip` means: replace this with your MySQL IP address or set it as a local variable in your terminal session.
|
||||||
|
|
||||||
|
All commands, parameters and examples are documented here: [docs/CLI.md](docs/CLI.md)
|
||||||
# Known issues
|
# Known issues
|
||||||
| Issue | Solution |
|
| Issue | Solution |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
|
|||||||
@@ -1,9 +1,4 @@
|
|||||||
# Using the CLI
|
# CLI
|
||||||
Before anything follow these steps:
|
|
||||||
1. Enter the project's `src` directory (used as the working directory in all examples)
|
|
||||||
2. Build the project: `dotnet build`
|
|
||||||
All user-defined parameters are denoted using the `$` symbol. I.e. `$mysql_ip` means: replace this with your MySQL IP address or set it as a local variable in your terminal session.
|
|
||||||
|
|
||||||
## Database
|
## Database
|
||||||
### Create or check
|
### Create or check
|
||||||
`src/cli/bin/Debug/net8.0/cli -h $mysql_ip -p $mysql_port -U $mysql_username -P $mysql_password --database --create [--setup]`
|
`src/cli/bin/Debug/net8.0/cli -h $mysql_ip -p $mysql_port -U $mysql_username -P $mysql_password --database --create [--setup]`
|
||||||
|
|||||||
Reference in New Issue
Block a user