makefile

indexing/Makefile

@@ -0,0 +1,41 @@
+PYTHON ?= python3.10
+VENV   := .venv
+BIN    := $(VENV)/bin
+PIP    := $(BIN)/pip
+
+.PHONY: help venv install dev lint format check clean
+
+help:
+	@echo "Targets:"
+	@echo "  venv     - create .venv with $(PYTHON)"
+	@echo "  install  - install ragstudio into venv"
+	@echo "  dev      - install ragstudio with dev extras (ruff)"
+	@echo "  lint     - run ruff check"
+	@echo "  format   - run ruff format"
+	@echo "  check    - lint + format --check"
+	@echo "  clean    - remove venv and build artifacts"
+
+$(VENV)/bin/activate:
+	$(PYTHON) -m venv $(VENV)
+	$(PIP) install --upgrade pip
+
+venv: $(VENV)/bin/activate
+
+install: venv
+	$(PIP) install -e .
+
+dev: venv
+	$(PIP) install -e ".[dev]"
+
+lint: dev
+	$(BIN)/ruff check .
+
+format: dev
+	$(BIN)/ruff format .
+
+check: dev
+	$(BIN)/ruff check .
+	$(BIN)/ruff format --check .
+
+clean:
+	rm -rf $(VENV) build dist *.egg-info .ruff_cache

indexing/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ragstudio"
+version = "0.1.0"
+description = "Local semantic search over a folder of text + images."
+requires-python = ">=3.10,<3.11"
+dependencies = [
+    "sentence-transformers>=3.0.0",
+    "torch>=2.2.0",
+    "faiss-cpu>=1.8.0",
+    "pillow>=10.0.0",
+    "numpy>=1.26.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "ruff==0.15.14",
+]
+
+[tool.setuptools]
+py-modules = ["index", "query"]
+
+[tool.setuptools.packages.find]
+include = ["searchers*"]