Files
pepperplus-cb/README.md
JobvAlewijk c5b71450fc feat: LLM agent
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
2025-10-27 14:21:18 +01:00

1.5 KiB

Development environment

We begin by installing UV (very nice utility for managing packages and Python version):

# On MacOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh
# 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):

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):

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:

uv run --only-group test pytest

GitHooks

To activate automatic commits/branch name checks run:

git config --local core.hooksPath .githooks

If your commit fails its either: branch name != /description-of-branch , commit name != : description of the commit. : N25B-Num's