Merge pull request #175 from LLAMATOR-Core/main_3_4_0

Bump version to v3.4.0

Author: RomiconEZ

.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 3.3.0
+current_version = 3.4.0
 commit = False
 tag = False
 parse = (?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)(\-(?P<release>[a-z]+))?

README.md

@@ -14,7 +14,7 @@ Red Teaming python-framework for testing chatbots and GenAI systems
 ## Install 🚀
 
 ```bash
-pip install llamator==3.3.0
+pip install llamator==3.4.0
 ```
 
 ## Documentation 📚

docs/howtos.md

@@ -13,7 +13,7 @@
 ## Installation Guide
 
 ```bash
-pip install llamator==3.3.0
+pip install llamator==3.4.0
 ```
 
 ## Usage Guide (using LM Studio)

examples/llamator-api.ipynb

@@ -11,20 +11,24 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
    "metadata": {
     "ExecuteTime": {
-     "end_time": "2025-07-06T13:58:57.453098Z",
-     "start_time": "2025-07-06T13:58:57.059519Z"
+     "end_time": "2025-09-23T23:15:49.914432Z",
+     "start_time": "2025-09-23T23:15:48.231631Z"
     }
    },
+   "source": [
+    "%pip install llamator python-dotenv requests --upgrade --quiet\n",
+    "%pip show llamator"
+   ],
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
+      "Note: you may need to restart the kernel to use updated packages.\n",
       "Name: llamator\r\n",
-      "Version: 3.3.0\r\n",
+      "Version: 3.4.0\r\n",
       "Summary: Framework for testing vulnerabilities of GenAI systems.\r\n",
       "Home-page: https://github.com/LLAMATOR-Core/llamator\r\n",
       "Author: Roman Neronov, Timur Nizamov, Nikita Ivanov\r\n",
@@ -37,34 +41,36 @@
      ]
     }
    ],
-   "source": [
-    "%pip install llamator python-dotenv requests --upgrade --quiet\n",
-    "%pip show llamator"
-   ]
+   "execution_count": 1
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
    "metadata": {
     "ExecuteTime": {
-     "end_time": "2025-07-15T10:52:14.326798Z",
-     "start_time": "2025-07-15T10:52:08.534205Z"
+     "end_time": "2025-09-23T23:16:02.192727Z",
+     "start_time": "2025-09-23T23:15:53.249841Z"
     }
    },
-   "outputs": [],
    "source": [
     "import llamator"
-   ]
+   ],
+   "outputs": [],
+   "execution_count": 2
   },
   {
    "cell_type": "code",
-   "execution_count": 3,
    "metadata": {
     "ExecuteTime": {
-     "end_time": "2025-04-05T21:56:28.196836Z",
-     "start_time": "2025-04-05T21:56:28.195091Z"
+     "end_time": "2025-09-23T23:16:02.202719Z",
+     "start_time": "2025-09-23T23:16:02.198275Z"
     }
    },
+   "source": [
+    "import os\n",
+    "from dotenv import load_dotenv\n",
+    "\n",
+    "load_dotenv(\".env\")  # example of environment variables in the .env.example file"
+   ],
    "outputs": [
     {
      "data": {
@@ -77,12 +83,7 @@
      "output_type": "execute_result"
     }
    ],
-   "source": [
-    "import os\n",
-    "from dotenv import load_dotenv\n",
-    "\n",
-    "load_dotenv(\".env\")  # example of environment variables in the .env.example file"
-   ]
+   "execution_count": 3
   },
   {
    "cell_type": "markdown",
@@ -210,13 +211,15 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 2,
    "metadata": {
     "ExecuteTime": {
-     "end_time": "2025-07-15T10:52:22.481186Z",
-     "start_time": "2025-07-15T10:52:22.474697Z"
+     "end_time": "2025-09-23T23:16:02.720737Z",
+     "start_time": "2025-09-23T23:16:02.716536Z"
     }
    },
+   "source": [
+    "llamator.print_test_preset(\"all\")"
+   ],
    "outputs": [
     {
      "name": "stdout",
@@ -240,6 +243,17 @@
       "        \"num_transformations\": 5,\n",
       "        \"sigma\": 0.4\n",
       "    }),\n",
+      "    (\"cop\", {\n",
+      "        \"custom_dataset\": None,\n",
+      "        \"initial_principles\": None,\n",
+      "        \"language\": \"any\",\n",
+      "        \"multistage_depth\": 12,\n",
+      "        \"num_attempts\": 3,\n",
+      "        \"principle_library_size\": 12,\n",
+      "        \"similarity_penalty_threshold\": 0.8,\n",
+      "        \"similarity_penalty_weight\": 0.2,\n",
+      "        \"use_similarity_judge\": True\n",
+      "    }),\n",
       "    (\"crescendo\", {\n",
       "        \"custom_dataset\": None,\n",
       "        \"language\": \"any\",\n",
@@ -261,6 +275,7 @@
       "        \"multistage_depth\": 20,\n",
       "        \"num_attempts\": 3\n",
       "    }),\n",
+      "    (\"repetition_token\", { \"num_attempts\": 3, \"repeat_count\": 10 }),\n",
       "    (\"shuffle\", {\n",
       "        \"custom_dataset\": None,\n",
       "        \"language\": \"any\",\n",
@@ -296,9 +311,7 @@
      ]
     }
    ],
-   "source": [
-    "llamator.print_test_preset(\"all\")"
-   ]
+   "execution_count": 4
   },
   {
    "cell_type": "code",