KCH / docs /content-plan.md
bsamadi's picture
Update to pixi env
c032460

12-Month Content Plan for Kashi Coding Handbook

"Modern Python: From Packages to Production AI"


Q1 2026: Modern Python Foundation (Jan-Mar)

Theme: Setting up the modern Python development stack

January: Package Management Evolution

Post 1: "Beyond pip: Package Management with pixi.sh"

  • Why conda-forge matters for data science/AI
  • Installing pixi and basic commands
  • Creating reproducible environments
  • Comparison with Poetry, PDM, uv
  • When to use each tool
  • GitHub repo: pixi-starter-templates

Post 2: "Multi-Project Workspace with pixi"

  • Managing multiple related projects
  • Shared dependencies across projects
  • Lock files and reproducibility
  • Integration with Docker
  • GitHub repo: pixi-monorepo-example

February: Professional CLI Development

Post 3: "Building CLI Tools with Typer"

  • Type hints-driven interfaces
  • Commands, options, and arguments
  • Auto-generated documentation
  • Testing CLI applications with pytest
  • GitHub repo: typer-starter-kit

Post 4: "Advanced CLI Patterns: Progress Bars, Config Files, and Plugins"

  • Rich integration for beautiful output
  • Configuration management (TOML, YAML)
  • Plugin architecture
  • Distributing CLI tools
  • GitHub repo: advanced-cli-patterns

March: Docker & Containerization

Post 5: "Docker for Python Development"

  • Multi-stage builds for Python apps
  • Managing dependencies in containers
  • Docker Compose for development stacks
  • Volume mounting and hot reload
  • GitHub repo: python-docker-templates

Post 6: "Containerizing AI Applications"

  • GPU support in Docker
  • Model serving containers
  • Environment variables and secrets
  • Your TrueNAS/Coolify setup as case study
  • GitHub repo: ai-docker-stack

Q2 2026: LLM Applications & Foundations (Apr-Jun)

Theme: Building blocks for AI applications

April: LangChain Fundamentals

Post 7: "Building Your First RAG Application with LangChain"

  • Document loaders and text splitters
  • Vector stores (using Supabase pgvector!)
  • Retrieval chains
  • Basic prompt engineering
  • GitHub repo: langchain-rag-starter

Post 8: "LangChain Memory Systems"

  • Conversation memory patterns
  • Message history with Supabase
  • Context window management
  • When to use which memory type
  • GitHub repo: langchain-memory-examples

May: MCP (Model Context Protocol)

Post 9: "Building Your First MCP Server"

  • MCP architecture overview
  • Database connector server (your actual work!)
  • Tool creation and registration
  • Testing MCP servers
  • GitHub repo: mcp-starter-pack

Post 10: "Advanced MCP: Custom Tools and Integrations"

  • File system access tools
  • API integration tools
  • Docker container management tools
  • Connecting MCP to LangChain agents
  • GitHub repo: mcp-advanced-tools

June: Agent Observability

Post 11: "Observability for LLM Applications"

  • Logging strategies for LLM calls
  • Token counting and cost tracking
  • LangSmith integration
  • Debugging agent decisions
  • GitHub repo: llm-observability-toolkit

Post 12: "Testing Non-Deterministic Systems"

  • Testing strategies for LLM apps
  • Assertion patterns for AI outputs
  • Evaluation frameworks
  • CI/CD for AI applications
  • GitHub repo: ai-testing-patterns

Q3 2026: Multi-Agent Systems & Robotics (Jul-Sep)

Theme: Orchestrating multiple agents and physical systems

July: CrewAI Deep Dive

Post 13: "Building Multi-Agent Systems with CrewAI"

  • Agent roles and goals
  • Task delegation patterns
  • Sequential vs hierarchical crews
  • Real-world example: research automation
  • GitHub repo: crewai-examples

Post 14: "CrewAI Advanced Patterns"

  • Custom tools for agents
  • Inter-agent communication
  • Error handling and recovery
  • Observability for CrewAI (connects to Post 11)
  • GitHub repo: crewai-advanced