c5b71450fc
body: added the llmAgent class and made it run at the start.
modified the bdi_core to send a test message and recieve an awnser from LLM agent
Added a connection to a local llm via lmstudio.
Tests are Tba.
ref: N25B-207
56 lines
1.5 KiB
Markdown
56 lines
1.5 KiB
Markdown
## Development environment
|
|
We begin by installing UV (very nice utility for managing packages and Python version):
|
|
|
|
```bash
|
|
# On MacOS and Linux.
|
|
curl -LsSf https://astral.sh/uv/install.sh | sh
|
|
```
|
|
```bash
|
|
# On Windows.
|
|
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
|
|
```
|
|
|
|
Using UV, installing the packages and virtual environment is as simple as typing the following (inside the root directory of this repository):
|
|
|
|
```bash
|
|
uv sync
|
|
```
|
|
|
|
## Local LLM
|
|
|
|
To run a LLM locally download https://lmstudio.ai
|
|
When installing select developer mode, download a model (it will already suggest one) and run it (see developer window, status: running)
|
|
|
|
copy the url at the top right and replace LOCAL_LLM_URL with it + v1/chat/completions.
|
|
This + part might differ based on what model you choose.
|
|
|
|
copy the model name in the module loaded and replace LOCAL_LLM_MODEL.
|
|
|
|
|
|
## Running
|
|
To run the project (development server), execute the following command (while inside the root repository):
|
|
|
|
```bash
|
|
uv run fastapi dev src/control_backend/main.py
|
|
```
|
|
|
|
## Testing
|
|
Testing happens automatically when opening a merge request to any branch. If you want to manually run the test suite, you can do so by running the following:
|
|
|
|
```bash
|
|
uv run --only-group test pytest
|
|
```
|
|
|
|
## GitHooks
|
|
|
|
To activate automatic commits/branch name checks run:
|
|
|
|
```shell
|
|
git config --local core.hooksPath .githooks
|
|
```
|
|
|
|
If your commit fails its either:
|
|
branch name != <type>/description-of-branch ,
|
|
commit name != <type>: description of the commit.
|
|
<ref>: N25B-Num's
|