# Open source

Source: https://www.alouaniyoussef.com/open-source

## AI Stones

An AI harness for Claude Code: Markdown skills, guardrail hooks and JSON settings that protect and improve how the model operates.

- Languages: Markdown, JSON, Hook scripts
- Licence: MIT
- Repository (GitHub): https://github.com/alouani-youssef/stones
- npm: https://www.npmjs.com/package/ai-stones

- Guardrail hooks: access guard, blocked rm, atomic commits, and a gate that holds merges and publishes until local CI passes.
- 24 skills that load only when a task needs them, from test-first development to system prompts and golden sets.
- Installed per project with npx ai-stones init, tailored to the detected stack; MIT on npm.

## archio

Object storage in Go with a multi-node, high-availability cluster and semantic search over stored files, built on Docling.

- Languages: Go
- Licence: Apache-2.0
- Repository (GitHub): https://github.com/alouani-youssef/archio

- File processing, storage and delivery optimisation.
- Multi-node cluster setup for high availability.
- Semantic search over documents, built on Docling.

## translator

Low-cost, context-aware translation: NLLB-200 for simple text, an LLM above a complexity threshold, behind a three-tier cache.

- Languages: Python
- Licence: Apache-2.0
- Repository (GitHub): https://github.com/alouani-youssef/translator

- FastAPI service routing between NLLB-200 3.3B and an LLM (Gemini, Ollama or OpenRouter) by complexity.
- Exact, normalized and semantic cache on PostgreSQL with pgvector.
- Semantic search exposed to the LLM as a tool that fetches validated translation examples, lifting domain accuracy even with local LLMs.
- multilingual-e5 quality scoring; S3/MinIO JSON documents.

## Tracking kit

A Go/Gin user-recognition service and a TypeScript browser SDK, with every event HMAC-signed.

- Languages: Go (Gin), TypeScript
- Licence: Apache-2.0
- Repository (tracker): https://github.com/alouani-youssef/tracker
- Repository (tracking-sdk): https://github.com/alouani-youssef/tracking-sdk

- Gin service that receives and verifies tracking events for user recognition.
- TypeScript wrapper for browser-based tracking.
- HMAC request signing, so the service only accepts events from trusted clients.
- Contributed to the community as open source, and already running in production.

## pg_inspector

An MCP server that gives AI assistants safe, read-only access to PostgreSQL.

- Languages: Python
- Licence: Apache-2.0
- Repository (GitHub): https://github.com/alouani-youssef/pg_inspector

- Streamable HTTP with an API key, and stdio.
- Read-only SQL, schema inspection, EXPLAIN plans and a health snapshot.
- Five guided prompts for common investigations.
