semvec/pypi-packages huggingface dataset:
ragrep 0.2.1
Local semantic code recall with mxbai embeddings and SQLite
Requires Python: >=3.9
Keywords: semantic-search, embeddings, sqlite, code-search, local

# RAGrep

RAGrep is a dead-simple local semantic recall tool for code and text files.

It uses:
- `mxbai-embed-large` embeddings in-process (no server)
- a single local SQLite database file: `.ragrep.db`

No ChromaDB. No remote API keys.

## Install

```bash
pip install ragrep
```

## Embedding Model Storage

RAGrep downloads the embedding model automatically on first use.

Default model directories:
- Linux: `~/.config/ragrep/models`
- macOS: `~/Library/Application Support/ragrep/models`
- Windows: `%APPDATA%\\ragrep\\models`

Override with:
- env var: `RAGREP_MODEL_DIR`
- CLI flag: `--model-dir`
- Python API: `RAGrep(model_dir="...")`

## GPU Usage

RAGrep can use GPU for embeddings when available.

- Default behavior: `RAGREP_DEVICE=auto` (prefers `cuda`, then `mps`, then `cpu`)
- Override via env: `RAGREP_DEVICE=cpu|cuda|mps|cuda:0`
- Override via CLI: `--device ...`
- Override via Python API: `RAGrep(embedding_device="...")`
- Note: GPU usage requires a GPU-capable PyTorch build in your environment.
- Check runtime GPU support: `ragrep --check-gpu` (or `ragrep --check-gpu --json`)

## CLI Usage

Recall is the default command.

```bash
# Implied recall (auto-indexes when needed)
ragrep "authentication middleware"

# Explicit recall (same behavior)
ragrep recall "authentication middleware"

# Build/update index manually
ragrep index .

# Show stats
ragrep stats

# Stats alias
ragrep --stats
```

When `--path` is omitted, auto-indexing uses the previously indexed root if one exists;
otherwise it uses the current directory.

Indexing is incremental by default:
- new files are added
- modified files are re-embedded
- removed files are deleted from the index

CLI runs that index files print newly indexed file paths to stdout.

Useful flags:

```bash
ragrep "query text" --path . --limit 10 --db-path ./.ragrep.db
ragrep "query text" --model-dir ~/.config/ragrep/models --json
ragrep "query text" --device auto
ragrep index . --force
```

## Python Usage

```python
from ragrep import RAGrep

rag = RAGrep(
    db_path="./.ragrep.db",
    embedding_model="mxbai-embed-large",
    embedding_device="auto",
)
rag.index(".")

result = rag.recall("database transactions", limit=5)
for match in result["matches"]:
    print(match["score"], match["metadata"]["source"])

print(rag.stats())
rag.close()
```

Library methods:
- `index(path=".", force=False)`
- `recall(query, limit=20, path=".", auto_index=True)`
- `stats()`

Backwards-compatible aliases still available:
- `RAGSystem` (alias of `RAGrep`)
- `dump(...)` (alias of `recall(..., auto_index=False)` result list)

## Local Database

RAGrep stores everything in one SQLite file (default `./.ragrep.db`):
- indexed files and mtimes
- chunked source text
- embedding vectors
- index metadata (model, chunk settings, root path)

## Development

```bash
pip install -e .[dev]
python -m unittest discover -s tests -p 'test_*.py'
python -m build
twine check dist/*
```

## License

MIT
strx-changelog-generator 1.0.1
Git changelog generator in Markdown table format
Requires Python: >=3.10

# StraconX Changelog Generator

Generador de historial de cambios para repositorios Git en formato de tabla Markdown.

## Instalación
```bash
pip install -e .
```

## Uso
```bash
strx-changelog --path /ruta/al/repo
```
strx-bnm 0.2.2
Herramienta para crear nuevos módulos Odoo 20 siguiendo estándares de Initium
Requires Python: >=3.6

# strx-bnm (Initium Brand New Module)

Herramienta oficial de **Initium Services** para la creación estandarizada de nuevos módulos en **Odoo 20**.

## 🚀 Propósito

`strx-bnm` automatiza la creación de la estructura base de un módulo de Odoo siguiendo las mejores prácticas y estándares internos de Initium. Asegura que cada nuevo módulo nazca con los directorios obligatorios, configuraciones de versión correctas y placeholders listos para el desarrollo.

## ✨ Características

- **Estructura Odoo 20 Ready**: Genera el esqueleto completo con modelos, vistas, controladores, reportes y wizards.
- **Personalización Automática**: Reemplaza placeholders técnicos por el nombre de tu nuevo módulo.
- **Cumplimiento de Estándares**: Crea automáticamente las carpetas `tests/` y `static/readme/` necesarias para pasar las validaciones de pre-commit.
- **Changelog Inicial**: Genera un archivo `CHANGELOG.md` con la versión inicial `20.0.1.0.0`.
- **Plantilla Integrada**: Utiliza un esqueleto base optimizado y actualizado.

## 📦 Instalación

Puedes instalarlo directamente desde PyPI:

```bash
pip install strx-bnm
```

O desde el código fuente:

```bash
cd strx_bnm_tool
pip install .
```

## 🛠️ Uso

### 1. Configuración Inicial
La primera vez que lo ejecutes, te pedirá el directorio por defecto donde guardas tus módulos de Odoo:

```bash
strx-bnm
```

### 2. Crear un Módulo
Simplemente sigue el asistente interactivo:

```bash
strx-bnm
```

**Pasos:**
1. Introduce el nombre técnico (ej: `strx_mi_modulo`).
2. Confirma o cambia el directorio de creación.
3. ¡Listo! Tu módulo ha sido creado.

### 3. Reconfiguración
Si deseas cambiar el directorio por defecto de Odoo:

```bash
strx-bnm --config
```

## 📂 Estructura Generada

El módulo creado tendrá la siguiente estructura mínima:

```
mi_modulo/
├── CHANGELOG.md
├── README.rst (dentro de static/readme)
├── __init__.py
├── __manifest__.py
├── controllers/
├── data/
├── demo/
├── models/
├── report/
├── security/
├── static/
│   └── readme/
├── tests/
├── views/
└── wizard/
```

## 🛡️ Licencia

Propiedad de **STRACONX S.A.** - Licencia OPL-1.
strx-autocommit 1.0.1
Odoo technical autocommit tool with Pylint validation and Changelog synchronization
Requires Python: >=3.10

# StraconX Autocommit

Herramienta técnica para automatizar commits en Odoo con validación de reglas de migración.

## Características
- Validación automática vía Pylint (Initium Migration Rules).
- Análisis técnico de cambios (nuevos campos, funciones, vistas XML).
- Generación automática de mensajes de commit estructurados.
- Sincronización automática con `CHANGELOG.md`.

## Instalación

### Opción 1: Desde el repositorio de paquetes (PyPI)
```bash
pip install strx-autocommit
```

### Opción 2: Desarrollo Local (modo editable)
Si tienes el código fuente y quieres que los cambios se apliquen automáticamente:
```bash
cd strx_tools/strx_autocommit
pip install -e .
```

### dependencias
Este script requiere `pylint` para las validaciones:
```bash
pip install pylint
```

## Uso
```bash
strx-autocommit
```