Skip to content
View codecruz's full-sized avatar
๐Ÿ”
๐Ÿ”
  • 22:03 (UTC +01:00)

Block or report codecruz

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please donโ€™t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this userโ€™s behavior. Learn more about reporting abuse.

Report abuse
codecruz/README.md

๐Ÿ‘‹ Hi! I'm codecruz

Email

๐Ÿ› ๏ธ Full-stack developer from southern Spain, happiest knee-deep in data. I specialize in APIs, ETL and data migration (PHP ยท Python ยท JavaScript), with a soft spot for large-scale processing, GIS and web scraping. After hours I build things I'd actually use: Kana~boo, to learn Japanese; langstats, a Claude Code plugin that powers the language stats at the bottom of this page; annotate, another one, to point at parts of a local site and leave notes for Claude to carry out; spain-postal-codes, an open dataset of Spanish postal codes published on npm and Packagist; Preparados72h, a family emergency-preparedness portal and Android app, in Spanish and English, that works offline; and Currency Flow, the ECB's official euro exchange rates since 1999 as a free static JSON API and a PHP library. Lately I spend a lot of time where backend meets LLMs: MCP servers, RAG and agents that know when to hand work to a local model. Quality over quantity, always.

Buy Me a Coffee at ko-fi.com

๐Ÿš€ Personal Projects

๐Ÿ‘ปโœ๏ธ Kana~boo

Kana~boo live site

Learn Japanese from zero with Boo, a little ghost. It started with Hiragana & Katakana (charts, quizzes and a Romaji โ†’ Kana reverse mode) and now covers ~2,500 kanji from N5 to N1 plus Kotoba: vocabulary and grammar tracks from your first words up to โ‰ˆN2, kanji with furigana, stroke tracing practice and spaced-repetition reviews.

No sign-up needed: an optional free account syncs your progress across devices and unlocks a 40-badge achievements collection, an opt-in ranking and shareable image cards. Static and multilingual (๐Ÿ‡ช๐Ÿ‡ธ ES / ๐Ÿ‡ฌ๐Ÿ‡ง EN / ๐Ÿ‡ฏ๐Ÿ‡ต JA, route-based i18n): every dataset is validated at build time, SEO and analytics are covered by tests, and it uses privacy-friendly analytics.

๐Ÿ‡ช๐Ÿ‡ธ๐Ÿ“ฎ spain-postal-codes

spain-postal-codes live site spain-postal-codes on npm spain-postal-codes npm downloads per month codecruz/spain-postal-codes on Packagist

An open, versioned dataset of Spanish postal codes and the municipalities they serve, built from official INE data and refreshed automatically: 10,791 postal codes ยท 8,132 municipalities ยท 52 provinces. Use it as a CSV, a static JSON API (no server, no API key, open CORS), an npm package or a PHP library via Composer, all with the same API.

Offline lookup and accent-insensitive search with zero dependencies (~110 KB gzipped on npm), leading-zero recovery (1450 โ†’ 01450), INE codes to join with any other official statistic, and reproducible releases from the INE's twice-yearly electoral street map.

๐ŸŽ’๐Ÿ†˜ Preparados72h

Preparados72h live site Download the Preparados72h Android APK

A family emergency-preparedness portal and Android app that keeps working with no signal. Its supplies calculator uses official figures: water broken down by use, five age groups, dogs by size, hot weather, "no stove" mode, allergies, intolerances and diets, plus a sample menu and the real kilos to buy. Then an inventory with expiry dates tells you what's missing. Available in Spanish and English (๐Ÿ‡ช๐Ÿ‡ธ ES / ๐Ÿ‡ฌ๐Ÿ‡ง EN), on the web and in the app.

Also: 14 step-by-step guides per emergency (blackout, flood, earthquake, wildfire, cyberattackโ€ฆ), emergency kits and what each country asks for, survival skills with offline illustrations, a Morse code translator and SOS emitter, offline meeting points and nearby emergency services, and a battery-saving blackout mode. Official weather warnings by region and curated news are refreshed every 6 hours by GitHub Actions, which also builds the APK and deploys both the site and the app download to Cloudflare Pages. Cookieless analytics, accessibility reviewed.

๐Ÿ’ฑ๐Ÿ‡ช๐Ÿ‡บ Currency Flow

Currency Flow live site codecruz/currency-flow on Packagist

The official euro exchange rates published by the European Central Bank, every business day since 1999: 29 active currencies ยท 12 discontinued. Use them as a static JSON API on GitHub Pages (no server, no API key, open CORS), a PHP library via Composer or a self-hosted HTTP API with an OpenAPI 3.1 spec.

Cross rates and conversions between any two currencies, weekends and holidays resolved to the previous publication (and every answer says which date was used), and rates kept as the ECB's exact decimal strings, with no float rounding. GitHub Actions rebuilds the site after each ECB publication and refuses to publish data that fails validation. Docs and converter in 6 languages.

โš’๏ธ๐Ÿค– Hefesto

One control panel to rule them all: every AI tool on my machine, and the machine they run on. It reads the local records of Claude Code, Codex CLI, Gemini CLI, OpenCode and Ollama into one ledger: tokens, estimated cost, sessions, models and projects, with subscription limits and budgets that span tools. A projects view shows where everything I build with AI stands (spend, git, pull requests and CI) and starts any project locally with one button, next to the state of my services, containers, databases and local models.

It also listens and acts: an assistant you can talk to by text or voice (local Whisper in, local Piper out, in Spanish or English) answers fixed commands instantly, hands everything else to Claude Code and searches what was said in past sessions. When a project doesn't start, Claude fixes it, supervised or with full autonomy, and you can watch exactly what each fix is doing. Critical actions always go through a person: guardrails and your own rules, per command or per file, are enforced by Hefesto on every action, with a box to test a rule before trusting it.

The same numbers reach a React dashboard, a terminal UI, a CLI, a CSV/JSON export and an MCP server any agent can query to see what it, and every other tool, has spent. Everything is configured from one file, with modules you switch on (subscription limits, AI news, GitHub, or a script of your own), and it runs as an always-on desktop app.

Hefesto home: today's figures, subscription limits and budgets, and the AI tools and models found on the machine AI usage: daily tokens by tool, estimated cost, sessions and budgets across Claude Code and Codex CLI Projects: spend per tool, git branch, last commit and a Start button for every folder worked on with AI Guardrails: which critical actions ask a person first, are never allowed or stop being critical
Home ยท AI usage ยท Projects ยท Guardrails. Screenshots use demo data.

๐Ÿงฉ Claude Code Plugins

๐ŸŒธ๐Ÿ“Š langstats

langstats live site langstats on GitHub

A Claude Code plugin that records which languages Claude reads and edits while it works for you, and turns them into text bars for your GitHub profile README (the Code Crafting block below is generated by it). Bars can be flowers ๐ŸŒธ, rockets ๐Ÿš€, hearts ๐Ÿ’– or any emoji you like.

The hook runs in the background so it never slows Claude down, works on macOS, Linux and Windows, and GitHub is optional: connected, it updates your README by itself (with optional auto-publish); not connected, it hands you the block to paste.

๐Ÿ“๐Ÿ“ annotate

annotate live site annotate on GitHub

A Claude Code plugin to review a site the way you would with a colleague: point at things on your locally running site, write what you want changed, and Claude carries out the notes. A small local proxy adds an annotation layer to every page; each note travels with its element, page, window size and colour theme, so "too big on mobile" arrives with its context.

Press Send to Claude on the page and it finds the source behind each marked element, makes the change and removes the note: pins that remain are pending work. Mouse, touch, keyboard and screen reader, in English and Spanish. Everything stays on your computer, with no dependencies, and the proxy works with any other AI assistant too.

Both install from one marketplace: /plugin marketplace add codecruz/claude-plugins, then /plugin install langstats@codecruz or /plugin install annotate@codecruz.

๐Ÿงช More from the workshop

๐Ÿค– AI & agents

๐Ÿงญ Agent orchestrator ยท From first idea to Notion tasks, routing clear-cut work to local models.

Takes a project from first idea to a task breakdown in Notion. Frontier models plan, review and test; clear-cut tasks are delegated to local models depending on difficulty, scope and context size, and the router learns from its own hit/miss history.

Go Notion Ollama SQLite

๐Ÿง  MCP server with RAG ยท Internal docs queryable from Claude and ChatGPT, deployed continuously.

Makes internal documentation queryable from Claude and ChatGPT: PDF parsing and chunking, vector search in sqlite-vec, local models via Ollama. It adapts to how each group of people (a team, a department) uses it. Deployed continuously from GitHub Actions with an SSH key locked to a single command, no overlapping deploys and a health check gate.

Python MCP sqlite-vec Ollama GitHub Actions

๐Ÿ’ฌ Local RAG bot ยท Chat with a knowledge base without anything leaving the machine.

Chat over a knowledge base (Confluence, Notion, Outlineโ€ฆ) without anything leaving the machine: chunked ingestion, CPU embeddings, top-k retrieval and a 7B model answering with streaming.

Python FastEmbed Ollama Gradio

๐Ÿ’ผ DashJobs & jobprep ยท A job-search toolkit: from offers to a study plan, a tailored CV and interview prep.

Two local tools for anyone running a job search. DashJobs is the dashboard: it pulls your applications from LinkedIn and InfoJobs through your own signed-in browser, uses a local LLM to extract each offer's requirements, and turns them into a study plan with drafted notes on every topic. It syncs with Notion and keeps its data on your machine (JSON store with atomic writes, export/import backups).

jobprep takes each offer to the application. It builds a master profile from your previous CVs or your LinkedIn PDF (Claude proposes changes and you accept them one by one), checks the ad requirement by requirement against that profile, and asks you about whatever is unclear, turning your answers into new profile bullets. Then it generates a tailored two-page CV as a PDF and a cover letter, researches the company and builds an interview study page (with audio when the interview is in English), also as an EPUB for Kindle. Its AI runs through Claude Code on your own subscription, with no API key.

React Express Playwright Ollama Notion Python Claude Code

๐Ÿ› ๏ธ Infra & data

๐Ÿ” Tamper-evident audit framework ยท A hash-chained event log nobody, admins included, can quietly rewrite.

An isolated service other apps (SSO, CRM, internal tools) send their events to, so nobody, admins included, can quietly rewrite history. FastAPI ingestion โ†’ stream queue โ†’ worker that hash-chains every event โ†’ immutable store, synced to a read-only PostgreSQL copy for dashboards, plus an integrity checker that alerts on any mismatch.

The immutable store is immudb, an append-only database: records can be added but never updated or deleted, every key keeps its full history, and each entry comes with a cryptographic proof that a client can verify by itself. For traceability, that means every event keeps a who, what and when that can be checked later, and a past record can't change without the mismatch showing: evidence that holds up in an audit instead of a log you have to trust.

FastAPI Valkey Streams immudb PostgreSQL Superset

๐Ÿ“‰ Market screener ยท Stocks near historical lows, backtested and sent to Telegram.

Spots stocks trading near historical lows and alerts me on Telegram. Signals are checked with a point-in-time backtest (no look-ahead, no survivorship bias) and the engine is covered by 300+ tests.

Python Flask PostgreSQL pytest Telegram

๐Ÿ“ฑ Apps

โœˆ๏ธ Planedex ยท Point your phone at the sky and identify the plane flying over you.

A Pokรฉdex for planes: point your phone at the sky and identify the aircraft flying over you, using live ADS-B data, the camera and device sensors. Offline-first, so your collection survives with no signal.

Expo React Native SQLite

๐Ÿ‹๏ธ AniFit ยท A fitness diary where your training levels up an anime character.

A fitness diary with anime gamification: log steps, calories, protein, water, weight and workouts, find out which anime character archetype matches your body composition (FFMI + body fat), and see the positive and negative routes your habits lead to. Live demo.

FastAPI PostgreSQL React Vite TailwindCSS

โš ๏ธ Personal projects are under active development: features and demos may change.

๐Ÿ’ฌ Curious about any of these, or fancy building one together? Most of the repos are private for now, but I'm always happy to share the details, swap ideas or collaborate. Drop me a line at codecruz.mt@gmail.com.

๐Ÿ› ๏ธ Tech Stack

Category Technologies
๐ŸŒ Languages HTML CSS JavaScript TypeScript Python PHP Java Go Bash SQL
๐Ÿ–ฅ๏ธ Frameworks & Libraries FastAPI Django SQLAlchemy React Astro Vite Node.js Express Fastify Next.js Expo Capacitor Flask Symfony Laravel Pydantic Bootstrap Tailwind CSS
๐Ÿ“ฆ Databases & Messaging PostgreSQL MySQL MongoDB ChromaDB SQLite Redis / Valkey RabbitMQ
๐Ÿ“Š Data, AI & Integration ETL NumPy Pandas Matplotlib OpenCV Ollama Claude MCP RAG Chart.js Google Apps Script
๐Ÿค– Testing & Automation Playwright Selenium Puppeteer Scrapy pytest PHPUnit Cypress Mocha
โš™๏ธ Tools & Platforms Git GitHub GitLab CI Docker GitHub Actions Jenkins Caddy Traefik Cloudflare Pages Hetzner Vercel Postman OpenAPI New Relic Grafana Umami ESLint Prettier WordPress Drupal Notion
๐Ÿ–‹๏ธ IDEs & Editors Visual Studio Code Sublime Text
codecruz codecruz

๐Ÿ’ป Code Crafting

JavaScript                      ๐ŸŒธ๐ŸŒธ๐ŸŒธ๐ŸŒธ๐ŸŒธ๐ŸŒธ๐ŸŒฑยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท   25.93 %
TypeScript                      ๐ŸŒธ๐ŸŒธ๐ŸŒธ๐ŸŒธ๐ŸŒธ๐ŸŒธยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท   23.91 %
Python                          ๐ŸŒธ๐ŸŒธ๐ŸŒธ๐ŸŒธยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท   15.43 %
TSX                             ๐ŸŒธ๐ŸŒธ๐ŸŒฑยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท   09.75 %
HTML                            ๐ŸŒธ๐ŸŒธ๐ŸŒฑยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท   09.66 %
SQL                             ๐ŸŒธ๐ŸŒฑยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท   05.69 %
Other                           ๐ŸŒธ๐ŸŒธ๐ŸŒฑยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยทยท   09.63 %

visit counter

Pinned Loading

  1. spain-postal-codes spain-postal-codes Public

    ๐Ÿ‡ช๐Ÿ‡ธ Spanish postal codes from official INE data: open dataset (CSV), static JSON API on GitHub Pages and an npm package.

    Python 2

  2. php/doc-es php/doc-es Public

    Spanish translation of the PHP documentation

    XML 35 64

  3. langstats langstats Public

    Language stats for Claude Code, published to your GitHub profile README.

    Python 1

  4. currency-flow-api currency-flow-api Public

    ๐Ÿ’ฑ Official ECB euro exchange rates since 1999: free static JSON API on GitHub Pages and a PHP library on Packagist. Cross rates, conversions, daily updates.

    PHP