Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions CONTENT_GAPS_ANALYSIS.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ This document tracks structural and quality gaps that impact completeness and di

| Metric | Value |
|:-------|:------|
| Tutorial directories | 195 |
| Tutorials with exactly 8 numbered chapters | 192 |
| Tutorial directories | 201 |
| Tutorials with exactly 8 numbered chapters | 198 |
| Tutorials with >8 numbered chapters | 3 |
| Tutorials with 0 numbered chapters | 0 |
| Tutorials with partial chapter coverage (1-7) | 0 |
Expand All @@ -23,12 +23,12 @@ Top chapter-count tutorials:
- `langchain-tutorial`: 9 numbered chapter files
- `ag2-tutorial`: 9 numbered chapter files
- `wshobson-agents-tutorial`: 8 numbered chapter files
- `windmill-tutorial`: 8 numbered chapter files
- `whisper-cpp-tutorial`: 8 numbered chapter files
- `vllm-tutorial`: 8 numbered chapter files
- `vibesdk-tutorial`: 8 numbered chapter files
- `vibe-kanban-tutorial`: 8 numbered chapter files
- `vercel-ai-tutorial`: 8 numbered chapter files
- `use-mcp-tutorial`: 8 numbered chapter files

### 2) Index Format Variance

Expand Down
6 changes: 6 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -210,6 +210,7 @@ Build autonomous AI systems that reason, plan, and collaborate.
| **[Wshobson Agents](tutorials/wshobson-agents-tutorial/)** | 29.9K+ | TypeScript | Pluginized multi-agent workflows with specialist Claude Code agents |
| **[MetaGPT](tutorials/metagpt-tutorial/)** | 66K+ | Python | Multi-agent framework with role-based collaboration (PM, Architect, Engineer) for software generation |
| **[A2A Protocol](tutorials/a2a-protocol-tutorial/)** | 23K+ | Python/TypeScript | Google's Agent-to-Agent protocol for cross-platform agent interoperability and discovery |
| **[OpenAI Agents](tutorials/openai-agents-tutorial/)** | 20K+ | Python | Official OpenAI multi-agent SDK with handoffs, guardrails, and streaming |

### 🧠 LLM Frameworks & RAG

Expand All @@ -231,6 +232,7 @@ Retrieval-augmented generation, model serving, and LLM tooling.
| **[Semantic Kernel](tutorials/semantic-kernel-tutorial/)** | 23K+ | C#/Python | Microsoft's AI orchestration SDK |
| **[Fabric](tutorials/fabric-tutorial/)** | 26K+ | Go/Python | AI prompt pattern framework |
| **[Langflow](tutorials/langflow-tutorial/)** | 145K+ | Python/React | Visual AI agent and workflow platform with flow composition, APIs, and MCP deployment |
| **[Crawl4AI](tutorials/crawl4ai-tutorial/)** | 62K+ | Python | LLM-friendly web crawler for RAG pipelines with markdown generation and structured extraction |

### 🖥️ LLM Infrastructure & Serving

Expand Down Expand Up @@ -370,6 +372,10 @@ AI coding assistants, build systems, and dev infrastructure.
| **[Onlook](tutorials/onlook-tutorial/)** | 24.8K+ | TypeScript/React | Visual-first AI coding for Next.js and Tailwind with repo-backed edits |
| **[Opcode](tutorials/opcode-tutorial/)** | 20.7K+ | TypeScript/Electron | GUI command center for Claude Code sessions, agents, and MCP servers |
| **[Shotgun](tutorials/shotgun-tutorial/)** | 625+ | TypeScript | Spec-driven development workflows for large coding changes |
| **[tldraw](tutorials/tldraw-tutorial/)** | 46K+ | TypeScript | Infinite canvas SDK with AI "make-real" feature for generating apps from whiteboard sketches |
| **[Appsmith](tutorials/appsmith-tutorial/)** | 39K+ | TypeScript/Java | Low-code internal tool builder with drag-and-drop UI, 25+ data connectors, and Git sync |
| **[Windmill](tutorials/windmill-tutorial/)** | 16K+ | TypeScript/Rust | Scripts to webhooks, workflows, and UIs — open-source Retool + Temporal alternative |
| **[E2B](tutorials/e2b-tutorial/)** | 11K+ | Python/TypeScript | Secure cloud sandboxes for AI agent code execution with sub-200ms cold start |

#### Memory, Skills & Context

Expand Down
2 changes: 1 addition & 1 deletion TUTORIAL_STRUCTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ tutorials/<tutorial-name>/

| Pattern | Count |
|:--------|:------|
| `root_only` | 195 |
| `root_only` | 201 |
| `docs_only` | 0 |
| `index_only` | 0 |
| `mixed` | 0 |
Expand Down
6 changes: 6 additions & 0 deletions categories/ai-ml-platforms.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,6 +171,12 @@
- [Plane](../tutorials/plane-tutorial/)
- [MetaGPT](../tutorials/metagpt-tutorial/)
- [A2A Protocol](../tutorials/a2a-protocol-tutorial/)
- [Appsmith](../tutorials/appsmith-tutorial/)
- [tldraw](../tutorials/tldraw-tutorial/)
- [Windmill](../tutorials/windmill-tutorial/)
- [Crawl4AI](../tutorials/crawl4ai-tutorial/)
- [E2B](../tutorials/e2b-tutorial/)
- [OpenAI Agents](../tutorials/openai-agents-tutorial/)

## Suggest Additions

Expand Down
16 changes: 16 additions & 0 deletions discoverability/query-coverage.json
Original file line number Diff line number Diff line change
Expand Up @@ -308,6 +308,22 @@
],
"slug": "ollama-tutorial",
"title": "Ollama Tutorial: Running and Serving LLMs Locally"
},
{
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crawl4ai-tutorial/README.md",
"intent_signals": [
"rag-implementation"
],
"slug": "crawl4ai-tutorial",
"title": "Crawl4AI Tutorial: LLM-Friendly Web Crawling for RAG Pipelines"
},
{
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tldraw-tutorial/README.md",
"intent_signals": [
"rag-implementation"
],
"slug": "tldraw-tutorial",
"title": "tldraw Tutorial: Infinite Canvas SDK with AI-Powered \"Make Real\" App Generation"
}
]
},
Expand Down
6 changes: 5 additions & 1 deletion discoverability/query-hub.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Auto-generated high-intent query landing surface mapped to the most relevant tutorials.

- Total tutorials indexed: **195**
- Total tutorials indexed: **201**
- Query hubs: **6**
- Source: `scripts/generate_discoverability_assets.py`

Expand Down Expand Up @@ -103,6 +103,10 @@ Recommended tutorials:
- Deep technical walkthrough of Quivr Tutorial: Open-Source RAG Framework for Document Ingestion.
- [Ollama Tutorial: Running and Serving LLMs Locally](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ollama-tutorial/README.md)
- Learn how to use ollama/ollama for local model execution, customization, embeddings/RAG, integration, and production deployment.
- [Crawl4AI Tutorial: LLM-Friendly Web Crawling for RAG Pipelines](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crawl4ai-tutorial/README.md)
- Deep technical walkthrough of Crawl4AI Tutorial: LLM-Friendly Web Crawling for RAG Pipelines.
- [tldraw Tutorial: Infinite Canvas SDK with AI-Powered "Make Real" App Generation](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tldraw-tutorial/README.md)
- Learn how to use tldraw/tldraw to build, customize, and extend an infinite canvas — from embedding the editor and creating custom shapes to integrating the "make-real" AI feature that generates working applications from whiteboard sketches.

## LLM Infrastructure and Serving

Expand Down
20 changes: 12 additions & 8 deletions discoverability/search-intent-map.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Auto-generated topical clusters to strengthen internal linking and query-to-tutorial mapping.

- Total tutorials: **195**
- Total tutorials: **201**
- Total clusters: **9**
- Source: `scripts/generate_discoverability_assets.py`

Expand Down Expand Up @@ -64,7 +64,7 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto

## ai-coding-agents

- tutorial_count: **87**
- tutorial_count: **89**

- [A2A Protocol Tutorial: Building Interoperable Agent Systems With Google's Agent-to-Agent Standard](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/a2a-protocol-tutorial/README.md)
- intents: agentic-coding
Expand Down Expand Up @@ -116,7 +116,7 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
- intents: agentic-coding
- [Cline Tutorial: Agentic Coding with Human Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/README.md)
- intents: agentic-coding
- ... plus 62 more tutorials in this cluster
- ... plus 64 more tutorials in this cluster

## data-and-storage

Expand Down Expand Up @@ -195,10 +195,12 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto

## mcp-ecosystem

- tutorial_count: **37**
- tutorial_count: **39**

- [Anthropic API Tutorial: Build Production Apps with Claude](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anthropic-code-tutorial/README.md)
- intents: production-operations, mcp-integration
- [Appsmith Tutorial: Low-Code Internal Tools](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/appsmith-tutorial/README.md)
- intents: mcp-integration
- [Awesome MCP Servers Tutorial: Curating and Operating High-Signal MCP Integrations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/awesome-mcp-servers-tutorial/README.md)
- intents: tool-selection, mcp-integration
- [Cherry Studio Tutorial: Multi-Provider AI Desktop Workspace for Teams](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cherry-studio-tutorial/README.md)
Expand Down Expand Up @@ -245,16 +247,16 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
- intents: production-operations, mcp-integration
- [MCP Rust SDK Tutorial: Building High-Performance MCP Services with RMCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-rust-sdk-tutorial/README.md)
- intents: production-operations, mcp-integration
- [MCP Servers Tutorial: Reference Implementations and Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-servers-tutorial/README.md)
- intents: production-operations, mcp-integration
- ... plus 12 more tutorials in this cluster
- ... plus 14 more tutorials in this cluster

## rag-and-retrieval

- tutorial_count: **7**
- tutorial_count: **9**

- [ChromaDB Tutorial: Building AI-Native Vector Databases](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chroma-tutorial/README.md)
- intents: rag-implementation
- [Crawl4AI Tutorial: LLM-Friendly Web Crawling for RAG Pipelines](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crawl4ai-tutorial/README.md)
- intents: rag-implementation
- [Haystack: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/haystack-tutorial/README.md)
- intents: production-operations, architecture-deep-dive, rag-implementation
- [LanceDB Tutorial: Serverless Vector Database for AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lancedb-tutorial/README.md)
Expand All @@ -267,6 +269,8 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
- intents: rag-implementation
- [RAGFlow Tutorial: Complete Guide to Open-Source RAG Engine](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ragflow-tutorial/README.md)
- intents: rag-implementation
- [tldraw Tutorial: Infinite Canvas SDK with AI-Powered "Make Real" App Generation](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tldraw-tutorial/README.md)
- intents: rag-implementation

## systems-and-internals

Expand Down
14 changes: 13 additions & 1 deletion discoverability/tutorial-directory.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

This page is auto-generated from the tutorial index and is intended as a fast browse surface for contributors and search crawlers.

- Total tutorials: **195**
- Total tutorials: **201**
- Source: `scripts/generate_discoverability_assets.py`

## A
Expand Down Expand Up @@ -33,6 +33,8 @@ This page is auto-generated from the tutorial index and is intended as a fast br
- Build and operate production-quality skills for Claude Code, Claude.ai, and the Claude API.
- [AnythingLLM Tutorial: Self-Hosted RAG and Agents Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/anything-llm-tutorial/README.md)
- Learn how to deploy and operate Mintplex-Labs/anything-llm for document-grounded chat, workspace management, agent workflows, and production use.
- [Appsmith Tutorial: Low-Code Internal Tools](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/appsmith-tutorial/README.md)
- Open-source low-code platform for building internal tools with drag-and-drop UI, 25+ database integrations, JavaScript logic, and Git sync.
- [Athens Research: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/athens-research-tutorial/README.md)
- Athens Research — An open-source, Roam-like knowledge management system built with ClojureScript and graph databases.
- [AutoAgent Tutorial: Zero-Code Agent Creation and Automated Workflow Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/autoagent-tutorial/README.md)
Expand Down Expand Up @@ -111,6 +113,8 @@ This page is auto-generated from the tutorial index and is intended as a fast br
- A practical guide to continuedev/continue, covering IDE usage, headless/CLI workflows, model configuration, team collaboration, and enterprise operations.
- [CopilotKit Tutorial: Building AI Copilots for React Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/README.md)
- Create in-app AI assistants, chatbots, and agentic UIs with the open-source CopilotKit framework.
- [Crawl4AI Tutorial: LLM-Friendly Web Crawling for RAG Pipelines](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crawl4ai-tutorial/README.md)
- Deep technical walkthrough of Crawl4AI Tutorial: LLM-Friendly Web Crawling for RAG Pipelines.
- [Create Python Server Tutorial: Scaffold and Ship MCP Servers with uvx](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-python-server-tutorial/README.md)
- Learn how to use modelcontextprotocol/create-python-server to scaffold Python MCP servers with minimal setup, template-driven primitives, and publish-ready packaging workflows.
- [Create TypeScript Server Tutorial: Scaffold MCP Servers with TypeScript Templates](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/create-typescript-server-tutorial/README.md)
Expand All @@ -137,6 +141,8 @@ This page is auto-generated from the tutorial index and is intended as a fast br

## E

- [E2B Tutorial: Secure Cloud Sandboxes for AI Agent Code Execution](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/e2b-tutorial/README.md)
- Learn how to use e2b-dev/E2B to give AI agents secure, sandboxed cloud environments for code execution with sub-200ms cold starts.
- [ElizaOS: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/elizaos-tutorial/README.md)
- ElizaOS — Autonomous agents for everyone.
- [Everything Claude Code Tutorial: Production Configuration Patterns for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/everything-claude-code-tutorial/README.md)
Expand Down Expand Up @@ -320,6 +326,8 @@ This page is auto-generated from the tutorial index and is intended as a fast br
- Learn from langchain-ai/open-swe architecture, workflows, and operational patterns, including how to maintain or migrate from a deprecated codebase.
- [Open WebUI Tutorial: Self-Hosted AI Workspace and Chat Interface](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/README.md)
- Learn how to run and operate open-webui/open-webui as a self-hosted AI interface with model routing, RAG workflows, multi-user controls, and production deployment patterns.
- [OpenAI Agents Tutorial: Building Production Multi-Agent Systems](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-agents-tutorial/README.md)
- Production Successor to Swarm: The OpenAI Agents SDK brings Swarm's lightweight agent-handoff philosophy into a production-grade framework with built-in tracing, guardrails, and streaming.
- [OpenAI Python SDK Tutorial: Production API Patterns](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-python-sdk-tutorial/README.md)
- Learn how to build reliable Python integrations with openai/openai-python using Responses-first architecture, migration-safe patterns, and production operations.
- [OpenAI Realtime Agents Tutorial: Voice-First AI Systems](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openai-realtime-agents-tutorial/README.md)
Expand Down Expand Up @@ -435,6 +443,8 @@ This page is auto-generated from the tutorial index and is intended as a fast br
- Teable — A high-performance, multi-dimensional database platform built on PostgreSQL with real-time collaboration.
- [tiktoken Tutorial: OpenAI Token Encoding & Optimization](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tiktoken-tutorial/README.md)
- Master tiktoken, OpenAI's fast BPE tokenizer, to accurately count tokens, optimize prompts, and reduce API costs.
- [tldraw Tutorial: Infinite Canvas SDK with AI-Powered "Make Real" App Generation](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/tldraw-tutorial/README.md)
- Learn how to use tldraw/tldraw to build, customize, and extend an infinite canvas — from embedding the editor and creating custom shapes to integrating the "make-real" AI feature that generates working applications from whiteboard sketches.
- [Turborepo Tutorial: High-Performance Monorepo Build System](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/turborepo-tutorial/README.md)
- A deep technical walkthrough of Turborepo covering High-Performance Monorepo Build System.

Expand All @@ -458,5 +468,7 @@ This page is auto-generated from the tutorial index and is intended as a fast br

- [Whisper.cpp Tutorial: High-Performance Speech Recognition in C/C++](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/whisper-cpp-tutorial/README.md)
- A deep technical walkthrough of Whisper.cpp covering High-Performance Speech Recognition in C/C++.
- [Windmill Tutorial: Scripts to Webhooks, Workflows, and UIs](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/windmill-tutorial/README.md)
- Turn scripts into production-ready webhooks, workflows, and internal tools with Windmill -- the open-source alternative to Retool + Temporal.
- [Wshobson Agents Tutorial: Pluginized Multi-Agent Workflows for Claude Code](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/wshobson-agents-tutorial/README.md)
- Learn how to use wshobson/agents to install focused Claude Code plugins, coordinate specialist agents, and run scalable multi-agent workflows with clear model and skill boundaries.
Loading
Loading