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`