lokum-engine 0.1.1__tar.gz

lokum_engine-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kayra Yılmaz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lokum_engine-0.1.1/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: lokum-engine
+Version: 0.1.1
+Summary: LokumAI engines: RAG + MLX LoRA fine-tuning utilities
+Author: fox
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/<YOU>/lokum-engine
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: sentence-transformers
+Requires-Dist: faiss-cpu
+Requires-Dist: PyMuPDF
+Requires-Dist: python-docx
+Requires-Dist: pillow
+Requires-Dist: pytesseract
+Requires-Dist: libzim
+Requires-Dist: mlx-lm
+Requires-Dist: huggingface_hub
+Dynamic: license-file
+
+# lokum-engine
+
+LokumAI engines packaged as a Python library:
+- RAG (FAISS + sentence-transformers)
+- Fine-tuning runner (MLX LoRA) + ChatML-safe presplitting
+
+## Install
+```bash
+pip install lokum-engine
+```
+
+## Usage
+```python
+from lokum_engine.rag import RAGEngine
+from lokum_engine.finetune import FinetuneEngine
+```

lokum_engine-0.1.1/README.md

@@ -0,0 +1,16 @@
+# lokum-engine
+
+LokumAI engines packaged as a Python library:
+- RAG (FAISS + sentence-transformers)
+- Fine-tuning runner (MLX LoRA) + ChatML-safe presplitting
+
+## Install
+```bash
+pip install lokum-engine
+```
+
+## Usage
+```python
+from lokum_engine.rag import RAGEngine
+from lokum_engine.finetune import FinetuneEngine
+```

lokum_engine-0.1.1/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lokum-engine"
+version = "0.1.1"
+description = "LokumAI engines: RAG + MLX LoRA fine-tuning utilities"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "fox" }]
+dependencies = [
+  "numpy",
+  "sentence-transformers",
+  "faiss-cpu",
+  "PyMuPDF",
+  "python-docx",
+  "pillow",
+  "pytesseract",
+  "libzim",
+  "mlx-lm",
+  "huggingface_hub",
+]
+
+[project.urls]
+Homepage = "https://github.com/<YOU>/lokum-engine"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

lokum_engine-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

lokum_engine-0.1.1/src/lokum_engine/__init__.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+from functools import partial
+
+from lokum_engine.rag.engine import RAGEngine
+from lokum_engine.rag import rag_engine_base, rag_engine_fab, rag_engine_mid
+from lokum_engine.finetune.engine import FinetuneEngine
+from lokum_engine.finetune import finetune_engine_base, finetune_engine_fab, finetune_engine_mid
+
+# “Tek satır import + constructor gibi kullanım” için:
+#   from lokum_engine import RAGEngineFab
+#   rag = RAGEngineFab(storage_dir="...", ...)
+RAGEngineBase = partial(RAGEngine, quality="base")
+RAGEngineMid = partial(RAGEngine, quality="mid")
+RAGEngineFab = partial(RAGEngine, quality="fab")
+
+#   from lokum_engine import FinetuneEngineFab
+#   ft = FinetuneEngineFab(model_path="...")
+FinetuneEngineBase = partial(FinetuneEngine, quality="base")
+FinetuneEngineMid = partial(FinetuneEngine, quality="mid")
+FinetuneEngineFab = partial(FinetuneEngine, quality="fab")
+
+__all__ = [
+    "RAGEngine",
+    "FinetuneEngine",
+    "rag_engine_base",
+    "rag_engine_mid",
+    "rag_engine_fab",
+    "RAGEngineBase",
+    "RAGEngineMid",
+    "RAGEngineFab",
+    "finetune_engine_base",
+    "finetune_engine_mid",
+    "finetune_engine_fab",
+    "FinetuneEngineBase",
+    "FinetuneEngineMid",
+    "FinetuneEngineFab",
+]

lokum_engine-0.1.1/src/lokum_engine/finetune/__init__.py

@@ -0,0 +1,45 @@
+"""Finetune helpers + exports."""
+
+from __future__ import annotations
+
+from functools import partial
+
+from lokum_engine.finetune.engine import FinetuneEngine
+from lokum_engine.finetune.engine import get_finetune_quality_profile, normalize_finetune_quality
+
+
+def finetune_engine_base(model_path: str) -> FinetuneEngine:
+    return FinetuneEngine(model_path=model_path, quality="base")
+
+
+def finetune_engine_mid(model_path: str) -> FinetuneEngine:
+    return FinetuneEngine(model_path=model_path, quality="mid")
+
+
+def finetune_engine_fab(model_path: str) -> FinetuneEngine:
+    return FinetuneEngine(model_path=model_path, quality="fab")
+
+
+finetune_engine_fabulous = finetune_engine_fab
+finetune_engine_faboulous = finetune_engine_fab
+
+
+# Constructor gibi
+FinetuneEngineBase = partial(FinetuneEngine, quality="base")
+FinetuneEngineMid = partial(FinetuneEngine, quality="mid")
+FinetuneEngineFab = partial(FinetuneEngine, quality="fab")
+
+
+__all__ = [
+    "FinetuneEngine",
+    "normalize_finetune_quality",
+    "get_finetune_quality_profile",
+    "finetune_engine_base",
+    "finetune_engine_mid",
+    "finetune_engine_fab",
+    "finetune_engine_fabulous",
+    "finetune_engine_faboulous",
+    "FinetuneEngineBase",
+    "FinetuneEngineMid",
+    "FinetuneEngineFab",
+]