Build a Private RAG Pipeline with Ollama and pgvector
A fully local retrieval-augmented generation stack: PostgreSQL with pgvector stores embeddings, Ollama runs the embedding and chat models. No API keys, no cloud, ~100 lines of Python.
Writing
Thoughts on Cloud Computing, DevOps, and Software Engineering.
Sharing lessons learned from building scalable systems.
Trace Your AI Agent with Langfuse: Self-Hosted LLM Observability
An agent that misbehaves is a black box until you trace it. Self-host Langfuse with Docker Compose, instrument a tool-calling agent with the Python SDK, and see every LLM call, tool execution, token count, and cost in one trace tree.
Build Your First MCP Server: Give an LLM Real Tools in 10 Minutes
A hands-on tutorial that builds a working MCP server exposing tools, resources, and prompts, then wires it into Claude Code. Copy-paste Python with the FastMCP SDK.
Building Multi-Agent Workflows with LangGraph: Supervisor Pattern in Python
A hands-on tutorial on building multi-agent systems with LangGraph. Covers the supervisor pattern, tool isolation, structured output routing, and the Functional API. With copy-paste Python code.
Getting Clean JSON from LLMs: Structured Outputs with Pydantic (OpenAI + Ollama)
LLM output is text until you make it typed. Learn how structured outputs and Pydantic turn raw model replies into validated Python objects, on both the OpenAI API and a local Ollama server. With copy-paste code.
Build an MCP Server in Python: From Zero to Working Tools
Step-by-step tutorial to build a custom MCP server in Python with SQLite-backed task management tools. Test it with the MCP Inspector, then connect it to Claude Desktop or VS Code.
How to Test and Debug MCP Servers with MCP Inspector
A tight feedback loop for MCP development: launch your server inside the Inspector, inspect its tools, call one by hand, and read the raw response. With the CLI mode for CI and the failure modes that break Claude Desktop connections.
Build an MCP Client That Connects to Multiple Servers in Python
Most MCP tutorials stop at one client, one server. Real agents need many. This guide builds a Python client that connects to two MCP servers in parallel, prefixes their tools to avoid collisions, and hands them to Claude as Anthropic-format tool definitions.
Get Reliable JSON from LLMs: Structured Outputs and Function Calling
Stop parsing LLM output with regex and hoping. Use structured outputs on OpenAI and Anthropic to get schema-compliant JSON, then layer validation on top.
Build a Tool-Using AI Agent with the Claude Agent SDK (Python)
Use Anthropic's official Claude Agent SDK to build a Python agent with custom tools, in-process MCP servers, PreToolUse hooks, and streaming output. Real code, no hand-waving.
Build Your First MCP Server: Give Any AI Client Access to Your Tools
A hands-on guide to the Model Context Protocol. Write a server that exposes tools, resources, and prompts over stdio or HTTP, then wire it into Claude Desktop, Cursor, or your own client. With copy-paste Python.
Build Your First Multi-Agent System with CrewAI
Give each AI agent a specific role, hand them real tools, and let them collaborate. Build a research-and-writing crew that researches a topic and writes a report — in under 30 minutes, all in Python.
PostgreSQL on Docker: Production Setup, Backup, and Performance Tuning
Run PostgreSQL in Docker with production-ready config. Covers initialization, persistent storage, automated backups with pg_dump, connection pooling, and performance tuning.
Kubernetes NGINX Ingress Controller: Setup, TLS, and Routing
Step-by-step guide to installing the NGINX Ingress Controller on Kubernetes, configuring path-based routing, and setting up automatic TLS certificates with cert-manager.
GitHub Actions CI/CD: Build and Push Docker Images with Layer Caching
A complete GitHub Actions workflow that builds a Docker image, caches layers between runs, and pushes to Docker Hub or GHCR. With copy-paste YAML and a comparison of cache strategies.
Docker Compose for Local Development: Node.js + PostgreSQL + Redis from Scratch
A hands-on guide to building a production-like local dev stack with Docker Compose. Covers service setup, volumes, health checks, environment variables, and hot reload with real working code.
Build Your First MCP Server in Python: A Hands-On Guide
Model Context Protocol is becoming the standard way to give LLMs access to tools and data. This guide walks you through building a real MCP server in Python, connecting it to Claude Code, and shipping it in under an hour.
Run a Local LLM Code Reviewer with Ollama and Continue.dev
A practical setup for a private, offline code reviewer. Pull a coding model in Ollama, wire it to VS Code through Continue, and review diffs without your code ever leaving the machine.
Ship a Remote MCP Server in TypeScript: From Local Dev to the Official Registry
Build a TypeScript MCP server with the official SDK, expose it over streamable HTTP, add OAuth 2.1, test it with the MCP Inspector, and publish it to the official MCP Registry. Production-grade setup, no hand-waving.
Build a Production RAG Pipeline with pgvector, Python, and the Anthropic API
A working RAG pipeline in 200 lines of Python: Postgres with pgvector, Voyage embeddings, Claude for generation, and an evaluation loop. Real commands, real costs, no hand-waving.
Self-Host LLMs with vLLM: A Production-Grade OpenAI-Compatible Server
Run open-source LLMs on your own GPU box and get an OpenAI-compatible API in one command. Covers install, PagedAttention, OpenAI server, performance tuning, and production deployment.
Ollama: Run Open-Source LLMs Locally with One Command
A hands-on guide to Ollama: install, pull a model, run it from the CLI, call it from Python and Node, build a custom Modelfile, and know when to use it instead of vLLM or a hosted API.
Build Your First MCP Server with Python
Give your LLM real tools. Build an MCP server in Python that exposes custom functions and resources — connect it to Claude Desktop in under 15 minutes.
Build Production-Ready Docker Images: From 2GB to 100MB
Six practical techniques to shrink Docker images by 90%, cut deployment time, and reduce your attack surface. With copy-paste examples for Go, Node.js, and Python.
Building Scalable CI/CD Pipelines with Jenkins and GitLab
Best practices for building reliable deployment pipelines for engineering teams — from concept to production-grade pipeline.
Cloud-Native Architecture: From Monolith to Microservices
Migration journey from monolith to microservices using Kubernetes and AWS. Lessons learned during the transition process.
Load Testing with k6.io: Beginner's Guide
Practical tutorial on using k6.io for load testing. Includes example scripts and result interpretation for production environments.
Infrastructure Monitoring with Prometheus and Grafana
Complete guide to setting up monitoring for production infrastructure. From installation to creating meaningful dashboards.
Build a CLI AI Agent with Ollama Tool Calling in Python
Step-by-step tutorial to build a local AI agent that reads files, runs shell commands, and handles multi-step requests using Ollama and Python. No cloud API needed.
Prompt Caching: Cut LLM API Costs by 50-90% with Claude and OpenAI
Stop paying full price for the same system prompt on every API call. A hands-on guide to prompt caching with Anthropic (automatic + explicit) and OpenAI — with copy-paste Python code and real cost comparisons.
Build Your First AI Agent with LangGraph: Tools, State, and Conditional Routing
A hands-on tutorial for building a stateful AI agent with LangGraph. We build a research assistant that searches the web, runs calculations, and routes between tools based on context — with copy-paste code and zero fluff.
Give Your LLM Superpowers: Build an MCP Server in 15 Minutes
A hands-on guide to building a Model Context Protocol server that lets Claude read your files, browse directories, and fetch URLs. Includes copy-paste Python code, MCP Inspector testing, and Claude Desktop integration.
HTTPS Without the Certificate Chore: Caddy for Static Sites and Reverse Proxies
Install Caddy, point it at a domain, and TLS certificates appear on their own. Hands-on steps for static hosting, reverse proxying, load balancing with health checks, and Basic Auth, all from one small Caddyfile.
Qdrant: Vector Database Setup, Semantic Search, and Hybrid Queries
Hands-on guide to running Qdrant with Docker and building semantic search in Python: collections, payload filters, named vectors, and hybrid search with RRF. Plus a straight answer on when to pick Qdrant over Chroma or pgvector.
Parallel Tool Calling: Make Your Agent Stop Round-Tripping One Call at a Time
One model response can carry several tool calls. The parallel tool calling pattern for the OpenAI and Anthropic APIs, with copy-paste Python loops, plus when sequential execution is the right call.
Build Your First MCP Server in Python
A copy-paste tutorial using the MCP Python SDK v2: expose tools, resources, and prompts, test with the Inspector, register with a host, and serve over HTTP. Every command verified against the official docs.
Build Your First MCP Server with Python
A hands-on tutorial using the current MCP Python SDK (v2). You will build a weather server, test it with an in-memory client, connect over stdio, and wire it into a real host like Claude Desktop.
Test Your AI Agent with pytest: An Eval Harness That Runs in CI
Chat demos do not catch the day your agent starts refunding orders it never looked up. Here is a pytest eval harness you can build in 30 minutes: golden dataset, deterministic tool-call checks, an LLM-as-judge for open-ended replies, and a CI gate.
Faster Terminal Searches with ripgrep, fzf, and bat: A Hands-On Review
A hands-on review of the ripgrep, fzf, and bat stack for instant terminal search. Install, real commands, piping them together, and when each beats grep, find, or IDE search.
Choosing an Agent Framework: Claude Agent SDK vs OpenAI Agents SDK vs LangGraph
Three frameworks, one task: an order-support agent that looks up orders, issues refunds, and escalates to a human. Same spec built three ways, with real code and a decision guide for when each one wins.
Build a Local RAG Chatbot with Ollama and Chroma
A private, offline retrieval-augmented generation chatbot that answers from your own documents. Copy-paste setup with Ollama for the models and Chroma for the vector store, no cloud API keys.
Structured Outputs: Stop Parsing Broken LLM JSON
Prompting for JSON is not the same as getting JSON. A copy-paste guide to OpenAI and Anthropic structured outputs with Pydantic: raw JSON Schema, refusal handling, schema limits, and a full invoice extractor.
Build Your First MCP Server in TypeScript
Build a working MCP server in TypeScript with the official SDK. Register a typed tool, test it with the MCP Inspector, and connect it to Claude Desktop, in four steps.
Semantic Search with Chroma: Retrieval Patterns That Actually Work
Hands-on semantic search with Chroma: real queries, metadata filters, full-text search, persistence, and a retrieval pipeline for RAG. Every snippet run for real, with the exact output printed.
Build Your First MCP Server in Python
A hands-on tutorial: build a small system-info MCP server in Python, test it in the MCP Inspector, and wire it into Claude Desktop. Includes copy-paste code and real commands.
Build Your Own MCP Server in Python
MCP lets Claude Desktop, Cursor, and other AI hosts use your tools without custom glue. Build a real weather server with the v2 Python SDK, test it in memory, over stdio, and over HTTP, then wire it into a host. Every snippet verified against mcp 2.0.0.
Stream LLM Responses Token by Token with Server-Sent Events
A working end-to-end setup that replaces the dead spinner with a live stream: a FastAPI backend that pushes OpenAI-compatible tokens over SSE, and a browser client that renders them as they arrive.
Multi-Agent Support Bot with the OpenAI Agents SDK: Handoffs, Guardrails, Escalation
Build a support bot that routes itself: a triage agent with handoffs, an input guardrail that blocks prompt injection before the main model runs, and escalations that carry structured metadata. Full working example on the OpenAI Agents SDK.
Build Your First MCP Server in 10 Minutes with the Python SDK
One standard way to hand an LLM tools, resources, and reusable prompts. Build a real MCP server with the official Python SDK, test it in the Inspector, and connect it to a host. Copy-paste ready.