improved description of repository, moved CLI info to README.md

This commit is contained in:
EzFeDezy
2025-05-10 16:23:45 +02:00
parent 0f11a30797
commit 85141c879f
2 changed files with 13 additions and 12 deletions

View File

@@ -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 |
| --- | --- | | --- | --- |

View File

@@ -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]`