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
4 changes: 2 additions & 2 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 | 175 |
| Tutorials with exactly 8 numbered chapters | 172 |
| Tutorial directories | 177 |
| Tutorials with exactly 8 numbered chapters | 174 |
| Tutorials with >8 numbered chapters | 3 |
| Tutorials with 0 numbered chapters | 0 |
| Tutorials with partial chapter coverage (1-7) | 0 |
Expand Down
2 changes: 2 additions & 0 deletions IMPORT_ROADMAP_TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,8 @@ This roadmap tracks the next highest-impact tutorial imports for `awesome-code-d
| [`modelcontextprotocol/ext-apps`](https://github.com/modelcontextprotocol/ext-apps) | 1k+ | P1 | `pack-br` | done |
| [`modelcontextprotocol/mcpb`](https://github.com/modelcontextprotocol/mcpb) | 1k+ | P1 | `pack-bs` | done |
| [`modelcontextprotocol/use-mcp`](https://github.com/modelcontextprotocol/use-mcp) | 1k+ | P1 | `pack-bs` | done |
| [`modelcontextprotocol/quickstart-resources`](https://github.com/modelcontextprotocol/quickstart-resources) | 900+ | P1 | `pack-bt` | done |
| [`modelcontextprotocol/create-python-server`](https://github.com/modelcontextprotocol/create-python-server) | 400+ | P1 | `pack-bt` | done |

## P2 (Strategic Extensions)

Expand Down
26 changes: 14 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@

[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
[![GitHub stars](https://img.shields.io/github/stars/johnxie/awesome-code-docs?style=social)](https://github.com/johnxie/awesome-code-docs)
[![Tutorials](https://img.shields.io/badge/tutorials-175-brightgreen.svg)](#-tutorial-catalog)
[![Content Hours](https://img.shields.io/badge/content-1880%2B%20hours-orange.svg)](#-tutorial-catalog)
[![Tutorials](https://img.shields.io/badge/tutorials-177-brightgreen.svg)](#-tutorial-catalog)
[![Content Hours](https://img.shields.io/badge/content-1900%2B%20hours-orange.svg)](#-tutorial-catalog)
[![Last Updated](https://img.shields.io/github/last-commit/johnxie/awesome-code-docs?label=updated)](https://github.com/johnxie/awesome-code-docs/commits/main)

[**Browse Tutorials**](#-tutorial-catalog) · [**A-Z Directory**](discoverability/tutorial-directory.md) · [**Learning Paths**](#-learning-paths) · [**Contributing**](#-contributing) · [**Community**](#-community)
Expand Down Expand Up @@ -68,7 +68,7 @@ Use this quick-start map if you searched for a specific outcome.
| build RAG systems | [LlamaIndex](tutorials/llamaindex-tutorial/) | [Haystack](tutorials/haystack-tutorial/) → [RAGFlow](tutorials/ragflow-tutorial/) |
| run LLMs locally or at scale | [Ollama](tutorials/ollama-tutorial/) | [llama.cpp](tutorials/llama-cpp-tutorial/) → [vLLM](tutorials/vllm-tutorial/) → [LiteLLM](tutorials/litellm-tutorial/) |
| build AI apps with TypeScript/Next.js | [Vercel AI SDK](tutorials/vercel-ai-tutorial/) | [CopilotKit](tutorials/copilotkit-tutorial/) → [LobeChat](tutorials/lobechat-ai-platform/) |
| build MCP tools and integrations | [MCP Python SDK](tutorials/mcp-python-sdk-tutorial/) | [FastMCP](tutorials/fastmcp-tutorial/) → [MCP Servers](tutorials/mcp-servers-tutorial/) → [Awesome MCP Servers](tutorials/awesome-mcp-servers-tutorial/) → [Composio](tutorials/composio-tutorial/) → [Daytona](tutorials/daytona-tutorial/) → [GenAI Toolbox](tutorials/genai-toolbox-tutorial/) → [awslabs/mcp](tutorials/awslabs-mcp-tutorial/) → [MCP Inspector](tutorials/mcp-inspector-tutorial/) → [MCP Registry](tutorials/mcp-registry-tutorial/) → [MCP Specification](tutorials/mcp-specification-tutorial/) → [MCP TypeScript SDK](tutorials/mcp-typescript-sdk-tutorial/) → [MCP Go SDK](tutorials/mcp-go-sdk-tutorial/) → [MCP Rust SDK](tutorials/mcp-rust-sdk-tutorial/) → [MCP Java SDK](tutorials/mcp-java-sdk-tutorial/) → [MCP C# SDK](tutorials/mcp-csharp-sdk-tutorial/) → [MCP Swift SDK](tutorials/mcp-swift-sdk-tutorial/) → [MCP Kotlin SDK](tutorials/mcp-kotlin-sdk-tutorial/) → [MCP Ruby SDK](tutorials/mcp-ruby-sdk-tutorial/) → [MCP PHP SDK](tutorials/mcp-php-sdk-tutorial/) → [MCP Ext Apps](tutorials/mcp-ext-apps-tutorial/) → [MCPB](tutorials/mcpb-tutorial/) → [use-mcp](tutorials/use-mcp-tutorial/) → [MCP Use](tutorials/mcp-use-tutorial/) |
| build MCP tools and integrations | [MCP Python SDK](tutorials/mcp-python-sdk-tutorial/) | [FastMCP](tutorials/fastmcp-tutorial/) → [MCP Servers](tutorials/mcp-servers-tutorial/) → [MCP Quickstart Resources](tutorials/mcp-quickstart-resources-tutorial/) → [Create Python Server](tutorials/create-python-server-tutorial/) → [Awesome MCP Servers](tutorials/awesome-mcp-servers-tutorial/) → [Composio](tutorials/composio-tutorial/) → [Daytona](tutorials/daytona-tutorial/) → [GenAI Toolbox](tutorials/genai-toolbox-tutorial/) → [awslabs/mcp](tutorials/awslabs-mcp-tutorial/) → [MCP Inspector](tutorials/mcp-inspector-tutorial/) → [MCP Registry](tutorials/mcp-registry-tutorial/) → [MCP Specification](tutorials/mcp-specification-tutorial/) → [MCP TypeScript SDK](tutorials/mcp-typescript-sdk-tutorial/) → [MCP Go SDK](tutorials/mcp-go-sdk-tutorial/) → [MCP Rust SDK](tutorials/mcp-rust-sdk-tutorial/) → [MCP Java SDK](tutorials/mcp-java-sdk-tutorial/) → [MCP C# SDK](tutorials/mcp-csharp-sdk-tutorial/) → [MCP Swift SDK](tutorials/mcp-swift-sdk-tutorial/) → [MCP Kotlin SDK](tutorials/mcp-kotlin-sdk-tutorial/) → [MCP Ruby SDK](tutorials/mcp-ruby-sdk-tutorial/) → [MCP PHP SDK](tutorials/mcp-php-sdk-tutorial/) → [MCP Ext Apps](tutorials/mcp-ext-apps-tutorial/) → [MCPB](tutorials/mcpb-tutorial/) → [use-mcp](tutorials/use-mcp-tutorial/) → [MCP Use](tutorials/mcp-use-tutorial/) |

---

Expand Down Expand Up @@ -97,7 +97,7 @@ This section tracks high-impact open-source vibe-coding and coding-agent ecosyst
```
╔════════════════════════════════════════════════════════════╗
║ 🤖 AI & AGENTS │ 🔧 DEV TOOLS │ 🗄️ DATA │ 🎤 SPEECH ║
║ 67+ tutorials │ 35 tutorials │ 14 tutorials │ 3 tutorials ║
║ 67+ tutorials │ 37 tutorials │ 14 tutorials │ 3 tutorials ║
╚════════════════════════════════════════════════════════════╝
```

Expand Down Expand Up @@ -220,6 +220,8 @@ AI coding assistants, build systems, and dev infrastructure.
| **[MCP Python SDK](tutorials/mcp-python-sdk-tutorial/)** | 21.4K+ | Python | Building MCP servers and tool integrations |
| **[FastMCP](tutorials/fastmcp-tutorial/)** | 22.8K+ | Python | MCP server/client framework, transports, and integration workflows |
| **[MCP Servers](tutorials/mcp-servers-tutorial/)** | 77.6K+ | Multi-lang | Reference MCP server implementations |
| **[MCP Quickstart Resources](tutorials/mcp-quickstart-resources-tutorial/)** | 984+ | Multi-lang | Official cross-language weather server and client quickstart corpus with smoke tests and protocol helpers |
| **[Create Python Server](tutorials/create-python-server-tutorial/)** | 476+ | Python/uv | Archived official scaffold tool for bootstrapping MCP Python servers with template-driven resources/prompts/tools |
| **[Awesome MCP Servers](tutorials/awesome-mcp-servers-tutorial/)** | 80.7K+ | Curated List | MCP server discovery, evaluation, and operations |
| **[Composio](tutorials/composio-tutorial/)** | 26.5K+ | Python/TypeScript | Agent toolkit integration, auth, providers, and MCP patterns |
| **[GenAI Toolbox](tutorials/genai-toolbox-tutorial/)** | 12.9K+ | Go/Node/Python | MCP-first database tools, `tools.yaml` control plane, and connector operations |
Expand Down Expand Up @@ -367,12 +369,12 @@ Continue ──→ Aider ──→ OpenHands ──→ Claude Code ──→ Cla
> *"I want to build AI tool servers and extend Claude with custom capabilities"*

```
MCP Python SDK ──→ FastMCP ──→ MCP Servers ──→ Awesome MCP Servers ──→ Composio ──→ Daytona ──→ GenAI Toolbox ──→ awslabs/mcp ──→ MCP Inspector ──→ MCP Registry ──→ MCP Specification ──→ MCP TypeScript SDK ──→ MCP Go SDK ──→ MCP Rust SDK ──→ MCP Java SDK ──→ MCP C# SDK ──→ MCP Swift SDK ──→ MCP Kotlin SDK ──→ MCP Ruby SDK ──→ MCP PHP SDK ──→ MCP Ext Apps ──→ MCPB ──→ use-mcp ──→ MCP Use
(build (build servers (reference (discovery and (tool + auth (sandbox (db-focused (aws server (debug + (publish + (protocol (client/server (go sdk + (rust rmcp + (java sdk + (csharp sdk + (swift sdk + (kmp core + (ruby server + (php server + (interactive ui + (bundle pack + (react hook + (full-stack
servers) fast) implementations) curation) runtime) infra) mcp control plane) ecosystem) transport tests) discovery ops) contract deep dive) sdk internals) conformance) task/oauth focus) spring modules) aspnet filters) lifecycle controls) transport model) client workflow) discovery model) host bridge model) sign verify) archived guidance) mcp workflows)
MCP Python SDK ──→ FastMCP ──→ MCP Servers ──→ MCP Quickstart Resources ──→ Create Python Server ──→ Awesome MCP Servers ──→ Composio ──→ Daytona ──→ GenAI Toolbox ──→ awslabs/mcp ──→ MCP Inspector ──→ MCP Registry ──→ MCP Specification ──→ MCP TypeScript SDK ──→ MCP Go SDK ──→ MCP Rust SDK ──→ MCP Java SDK ──→ MCP C# SDK ──→ MCP Swift SDK ──→ MCP Kotlin SDK ──→ MCP Ruby SDK ──→ MCP PHP SDK ──→ MCP Ext Apps ──→ MCPB ──→ use-mcp ──→ MCP Use
(build (build servers (reference (multi-lang (python scaffold (discovery and (tool + auth (sandbox (db-focused (aws server (debug + (publish + (protocol (client/server (go sdk + (rust rmcp + (java sdk + (csharp sdk + (swift sdk + (kmp core + (ruby server + (php server + (interactive ui + (bundle pack + (react hook + (full-stack
servers) fast) implementations) quickstart set) bootstrap path) curation) runtime) infra) mcp control plane) ecosystem) transport tests) discovery ops) contract deep dive) sdk internals) conformance) task/oauth focus) spring modules) aspnet filters) lifecycle controls) transport model) client workflow) discovery model) host bridge model) sign verify) archived guidance) mcp workflows)
```

**Duration:** 88-120 hours | **Difficulty:** Intermediate to Advanced
**Duration:** 95-130 hours | **Difficulty:** Intermediate to Advanced

### 🟢 Path 8: Speech & Voice AI

Expand Down Expand Up @@ -419,10 +421,10 @@ Dyad ──→ bolt.diy ──→ Cline ──→ Roo Code ──→ VibeSDK ─
╔══════════════════════════════════════════════════════════╗
║ COLLECTION OVERVIEW ║
╠══════════════════════════════════════════════════════════╣
║ 📦 Total Tutorials 175
║ 📝 Numbered Chapters 1,403
║ 📏 Tutorial Markdown 473,000+ lines ║
║ ⏱️ Estimated Hours 1,880+ ║
║ 📦 Total Tutorials 177
║ 📝 Numbered Chapters 1,419
║ 📏 Tutorial Markdown 474,000+ lines ║
║ ⏱️ Estimated Hours 1,900+ ║
║ ✅ Local Broken Links 0 ║
║ 🧭 Structure Drift 0 (all root canonical) ║
╚══════════════════════════════════════════════════════════╝
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` | 175 |
| `root_only` | 177 |
| `docs_only` | 0 |
| `index_only` | 0 |
| `mixed` | 0 |
Expand Down
6 changes: 4 additions & 2 deletions categories/ai-ml-platforms.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

## Snapshot (February 12, 2026)

- repository-wide tutorials: **175**
- repository-wide tutorials: **177**
- AI/agent + developer-tooling coverage: **largest cluster in the catalog**
- canonical structure status: **all tracks publish full chapter sets**

Expand All @@ -17,7 +17,7 @@
| Build vibe-coding products | [Dyad](../tutorials/dyad-tutorial/) | [bolt.diy](../tutorials/bolt-diy-tutorial/) → [VibeSDK](../tutorials/vibesdk-tutorial/) → [HAPI](../tutorials/hapi-tutorial/) |
| Build RAG systems | [LlamaIndex](../tutorials/llamaindex-tutorial/) | [Haystack](../tutorials/haystack-tutorial/) → [RAGFlow](../tutorials/ragflow-tutorial/) |
| Run LLMs in production | [Ollama](../tutorials/ollama-tutorial/) | [vLLM](../tutorials/vllm-tutorial/) → [LiteLLM](../tutorials/litellm-tutorial/) |
| Build MCP integrations | [MCP Python SDK](../tutorials/mcp-python-sdk-tutorial/) | [FastMCP](../tutorials/fastmcp-tutorial/) → [MCP Servers](../tutorials/mcp-servers-tutorial/) → [Awesome MCP Servers](../tutorials/awesome-mcp-servers-tutorial/) → [Composio](../tutorials/composio-tutorial/) → [Daytona](../tutorials/daytona-tutorial/) → [GenAI Toolbox](../tutorials/genai-toolbox-tutorial/) → [awslabs/mcp](../tutorials/awslabs-mcp-tutorial/) → [MCP Inspector](../tutorials/mcp-inspector-tutorial/) → [MCP Registry](../tutorials/mcp-registry-tutorial/) → [MCP Specification](../tutorials/mcp-specification-tutorial/) → [MCP TypeScript SDK](../tutorials/mcp-typescript-sdk-tutorial/) → [MCP Go SDK](../tutorials/mcp-go-sdk-tutorial/) → [MCP Rust SDK](../tutorials/mcp-rust-sdk-tutorial/) → [MCP Java SDK](../tutorials/mcp-java-sdk-tutorial/) → [MCP C# SDK](../tutorials/mcp-csharp-sdk-tutorial/) → [MCP Swift SDK](../tutorials/mcp-swift-sdk-tutorial/) → [MCP Kotlin SDK](../tutorials/mcp-kotlin-sdk-tutorial/) → [MCP Ruby SDK](../tutorials/mcp-ruby-sdk-tutorial/) → [MCP PHP SDK](../tutorials/mcp-php-sdk-tutorial/) → [MCP Ext Apps](../tutorials/mcp-ext-apps-tutorial/) → [MCPB](../tutorials/mcpb-tutorial/) → [use-mcp](../tutorials/use-mcp-tutorial/) → [MCP Use](../tutorials/mcp-use-tutorial/) |
| Build MCP integrations | [MCP Python SDK](../tutorials/mcp-python-sdk-tutorial/) | [FastMCP](../tutorials/fastmcp-tutorial/) → [MCP Servers](../tutorials/mcp-servers-tutorial/) → [MCP Quickstart Resources](../tutorials/mcp-quickstart-resources-tutorial/) → [Create Python Server](../tutorials/create-python-server-tutorial/) → [Awesome MCP Servers](../tutorials/awesome-mcp-servers-tutorial/) → [Composio](../tutorials/composio-tutorial/) → [Daytona](../tutorials/daytona-tutorial/) → [GenAI Toolbox](../tutorials/genai-toolbox-tutorial/) → [awslabs/mcp](../tutorials/awslabs-mcp-tutorial/) → [MCP Inspector](../tutorials/mcp-inspector-tutorial/) → [MCP Registry](../tutorials/mcp-registry-tutorial/) → [MCP Specification](../tutorials/mcp-specification-tutorial/) → [MCP TypeScript SDK](../tutorials/mcp-typescript-sdk-tutorial/) → [MCP Go SDK](../tutorials/mcp-go-sdk-tutorial/) → [MCP Rust SDK](../tutorials/mcp-rust-sdk-tutorial/) → [MCP Java SDK](../tutorials/mcp-java-sdk-tutorial/) → [MCP C# SDK](../tutorials/mcp-csharp-sdk-tutorial/) → [MCP Swift SDK](../tutorials/mcp-swift-sdk-tutorial/) → [MCP Kotlin SDK](../tutorials/mcp-kotlin-sdk-tutorial/) → [MCP Ruby SDK](../tutorials/mcp-ruby-sdk-tutorial/) → [MCP PHP SDK](../tutorials/mcp-php-sdk-tutorial/) → [MCP Ext Apps](../tutorials/mcp-ext-apps-tutorial/) → [MCPB](../tutorials/mcpb-tutorial/) → [use-mcp](../tutorials/use-mcp-tutorial/) → [MCP Use](../tutorials/mcp-use-tutorial/) |

## Featured AI/ML Tutorial Tracks

Expand Down Expand Up @@ -47,6 +47,8 @@
- [MCP Ext Apps](../tutorials/mcp-ext-apps-tutorial/)
- [MCPB](../tutorials/mcpb-tutorial/)
- [use-mcp](../tutorials/use-mcp-tutorial/)
- [MCP Quickstart Resources](../tutorials/mcp-quickstart-resources-tutorial/)
- [Create Python Server](../tutorials/create-python-server-tutorial/)
- [MCP Use](../tutorials/mcp-use-tutorial/)
- [OpenAI Python SDK](../tutorials/openai-python-sdk-tutorial/)
- [OpenAI Realtime Agents](../tutorials/openai-realtime-agents-tutorial/)
Expand Down
6 changes: 5 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: **175**
- Total tutorials: **177**
- Source: `scripts/generate_discoverability_assets.py`

## A
Expand Down Expand Up @@ -105,6 +105,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/index.md)
- Create in-app AI assistants, chatbots, and agentic UIs with the open-source CopilotKit framework.
- [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/index.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.
- [CrewAI Tutorial: Building Collaborative AI Agent Teams](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crewai-tutorial/index.md)
- **Latest Release (v0.193.0+)**: CrewAI has evolved significantly with support for GPT-4.1, Gemini-2.0/2.5 Pro, enhanced knowledge management, agent evaluation functionality, and improved Mem0 memory integration.
- [Crush Tutorial: Multi-Model Terminal Coding Agent with Strong Extensibility](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/crush-tutorial/index.md)
Expand Down Expand Up @@ -244,6 +246,8 @@ This page is auto-generated from the tutorial index and is intended as a fast br
- Learn how to implement MCP server workflows with `modelcontextprotocol/php-sdk`, including attribute discovery, manual capability registration, transport strategy, session storage, and framework integration patterns.
- [MCP Python SDK Tutorial: Building AI Tool Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-python-sdk-tutorial/index.md)
- Master the Model Context Protocol Python SDK to build custom tool servers that extend Claude and other LLMs with powerful capabilities.
- [MCP Quickstart Resources Tutorial: Cross-Language MCP Servers and Clients by Example](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-quickstart-resources-tutorial/index.md)
- Learn how to use `modelcontextprotocol/quickstart-resources` as a practical reference for multi-language MCP server/client implementations, protocol smoke testing, and onboarding workflows.
- [MCP Registry Tutorial: Publishing, Discovery, and Governance for MCP Servers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-registry-tutorial/index.md)
- Learn how `modelcontextprotocol/registry` works end to end: publishing authenticated server metadata, consuming the API as an aggregator, and operating registry infrastructure safely.
- [MCP Ruby SDK Tutorial: Building MCP Servers and Clients in Ruby](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mcp-ruby-sdk-tutorial/index.md)
Expand Down
Loading
Loading