System Design 101: la guía gratis de ByteByteGo para aprender diseño de sistemas

System Design 101 es el repositorio de ByteByteGo que explica en diagramas y texto corto cómo funcionan los sistemas que usas cada día: APIs, balanceadores de carga, bases de datos, caché, colas de mensajes, Kubernetes, pagos y casos reales de empresas como Netflix o Figma. Son 400 guías gratis repartidas en 15 categorías, con más de 90.000 estrellas en GitHub, y sirve tanto para preparar una entrevista de *system design* como para entender qué pasa por debajo de tu propia aplicación.

Hemos clonado y leído el repositorio ByteByteGoHq/system-design-101 (commit b28380a, del 4 de abril de 2025, el último publicado) para contarte qué contiene de verdad, cómo está organizado, en qué orden estudiarlo, cómo usarlo sin conexión o con Claude Code, y qué permite su licencia, que no es MIT ni open source: es CC BY-NC-ND 4.0, y eso cambia lo que puedes hacer con él.

Qué es System Design 101 y para qué sirve

El diseño de sistemas (*system design*) es la parte de la ingeniería que decide cómo se reparten las piezas de una aplicación cuando crece: dónde se guarda cada dato, qué se cachea, cómo se comunican los servicios, qué pasa cuando un servidor cae. Es también la entrevista que más pesa para puestos de backend *senior* en empresas grandes.

El problema es que el material suele estar disperso en papers, charlas y libros de 600 páginas. System Design 101 hace lo contrario: cada tema cabe en un diagrama y, casi siempre, entre 100 y 350 palabras. Lo mantiene ByteByteGo, la empresa de Alex Xu, autor de los libros *System Design Interview*, y es la versión abierta de las guías que publica en su web y su newsletter.

Qué incluye: los 400 temas por categoría

Contamos el frontmatter de cada guía del repositorio. Así se reparten:

Lo más útil de cada bloque, con el nombre de la guía tal como aparece en el repositorio:

• API y desarrollo web (50). REST frente a GraphQL, gRPC, HTTP/1 → HTTP/2 → HTTP/3, *polling* frente a webhooks, paginación, API Gateway, *proxy* frente a *reverse proxy* y seguridad de APIs.
• Cloud y sistemas distribuidos (49). Teorema CAP, *consistent hashing*, *sharding*, Kafka, colas de mensajes y estrategias de recuperación ante desastres.
• Bases de datos y almacenamiento (47). ACID, niveles de aislamiento, réplicas de lectura, estrategias para escalar una base de datos y Redis frente a Memcached.
• Seguridad (35). Sesiones, cookies, JWT, OAuth 2.0 y sus flujos, SSO y HTTPS.
• Casos reales (32). Cómo escaló Figma su Postgres 100 veces, el *stack* de Netflix, la evolución de los microservicios de Airbnb y el recorrido de un mensaje de Slack.
• Caché y rendimiento (29). Estrategias de caché, políticas de expulsión, qué puede salir mal con una caché y cifras de latencia que conviene saber.
• DevOps y CI/CD (27), arquitectura (24), desarrollo de software (28), herramientas (20), pagos y fintech (20), cómo funciona (18), fundamentos (12), IA y machine learning (8) y entrevistas técnicas (5).

Cómo está hecho el repositorio

Si vas a usarlo en serio, conviene saber qué hay en el disco al clonarlo:

• Un archivo Markdown por guía en data/guides/, con frontmatter YAML: title, description, image, createdAt, categories y tags. Las 15 categorías están en data/categories/.
• Los diagramas no están en el repo. Cada guía enlaza su imagen en assets.bytebytego.com, así que sin conexión tienes el texto pero no los dibujos.
• El README se genera solo. scripts/readme.ts lee las categorías y las guías con gray-matter y escribe el índice (pnpm update-readme). Los enlaces apuntan a la web, no a los archivos del repo.
• Todas las guías tienen fecha de 2024 (del 25 de enero al 16 de marzo). Es la migración del contenido al formato actual; desde abril de 2025 no hay commits nuevos.

Dos detalles que notarás al leer: hay temas repetidos con títulos parecidos (dos guías de buenas prácticas de microservicios, varias de estrategias de caché, media docena sobre sesiones, cookies y JWT) y las guías son cortas a propósito. Son un mapa, no un libro: te dicen qué existe y cómo encaja, y luego tú profundizas.

En qué orden estudiar System Design 101

El README sigue el orden de las categorías, que no es el mejor para aprender. Esta es la ruta que proponemos, de lo básico a la entrevista, con guías que existen en el repositorio:

1. Cómo viaja una petición. Proxy vs Reverse Proxy, What is a Load Balancer? y HTTP/1 -> HTTP/2 -> HTTP/3.
2. Cómo hablan los servicios. REST API vs. GraphQL, What is gRPC? y Polling vs Webhooks.
3. Dónde viven los datos. What does ACID mean?, What are database isolation levels? y Read Replica Pattern.
4. Hacerlo rápido. Top 5 Caching Strategies, How Can Cache Systems Go Wrong? y Which latency numbers should you know?.
5. Repartir la carga. A Crash Course on Database Sharding, Consistent Hashing Explained y CAP Theorem.
6. Desacoplar con colas. Why is Kafka Fast?, Can Kafka Lose Messages? y Top 6 Cases to Apply Idempotency.
7. Ver sistemas reales. 100X Postgres Scaling at Figma y Designing a Chat Application.
8. Preparar la entrevista. How to Ace System Design Interviews y Algorithms for System Design Interviews.

Con una o dos guías al día, la ruta completa son unas tres semanas. Lo que marca la diferencia es el paso siguiente: después de cada bloque, dibuja tú el diagrama sin mirar y explica en voz alta por qué cada pieza está ahí.

Cómo usarlo sin conexión y buscar por tema

Clonar el repositorio te da las 400 guías en texto plano, fáciles de buscar con grep. Lo probamos en Linux; los mismos comandos funcionan en macOS y en Git Bash para Windows.

git clone --depth 1 https://github.com/ByteByteGoHq/system-design-101.git
cd system-design-101
ls data/guides | wc -l

El último comando devuelve 400. Para listar todas las guías de una categoría (aquí, caché y rendimiento: 29 archivos):

grep -l "caching-performance" data/guides/*.md

Para encontrar cada guía que menciona un concepto, aunque no esté en el título:

grep -ril "consistent hashing" data/guides

Devuelve cuatro guías: la de *consistent hashing*, la de bloques básicos de *system design*, la de algoritmos de *sharding* y la del recorrido de un mensaje de Slack. Así se ve qué conceptos aparecen en varios contextos, que es justo lo que te preguntan en una entrevista.

En PowerShell, el equivalente de la búsqueda es:

Select-String -Path data\guides\*.md -Pattern "consistent hashing" -List | Select-Object Path

Estudiar System Design 101 con Claude Code

Con el repositorio clonado puedes abrir Claude Code en la carpeta y usarlo como tutor: lee las guías del disco y te pregunta sobre ellas. Un ejemplo de petición:

Lee las guías de data/guides de la categoría database-and-storage.
Hazme 10 preguntas de entrevista de system design, de una en una,
y corrige cada respuesta citando la guía que la explica.

Otra que funciona bien para la ruta de estudio:

Tengo 3 semanas para preparar una entrevista de backend.
Con los títulos y categorías de data/guides, arma un plan diario
de 2 guías y marca qué temas aparecen en varias guías.

Esto entra en el uso personal que permite la licencia. Lo que no puedes hacer es publicar lo que genere el agente si es una traducción o un resumen de las guías: eso ya es una obra derivada, y la licencia no permite compartirla.

Licencia de System Design 101: qué puedes hacer

El archivo LICENSE.md dice que el contenido está bajo Creative Commons Atribución-NoComercial-SinDerivadas 4.0 Internacional (CC BY-NC-ND 4.0). GitHub la muestra como «Other» porque no es una licencia de software, y el package.json tiene una errata (cc-by-nc-sd-4.0), pero el texto que vale es el de LICENSE.md.

En la práctica:

• Puedes leerlo, clonarlo y estudiarlo gratis, también si trabajas en una empresa.
• Puedes compartir el enlace o una copia sin cambios, citando a ByteByteGo y la licencia, siempre que no sea con fines comerciales.
• No puedes publicar una traducción ni una versión editada (ND). Esto incluye un PDF en español hecho a partir de las guías o un resumen con los diagramas.
• No puedes usarlo con fines comerciales (NC): ni en un curso de pago, ni en un ebook, ni en una web con publicidad.
• Las ideas no tienen copyright. El teorema CAP o el *consistent hashing* son conocimiento general; puedes explicarlos con tus palabras y tus propios diagramas.

Por eso este artículo no reproduce ninguno de sus diagramas: los gráficos que ves son nuestros, hechos a partir de contar los archivos del repositorio. Es una licencia mucho más restrictiva que la MIT o la Apache 2.0 de la mayoría de proyectos que tratamos aquí. Si tu idea es crear material derivado, lo que te sirve es una alternativa con licencia más abierta.

Un último detalle de CONTRIBUTING.md: el proyecto acepta *pull requests* de un solo tema, pide no usar herramientas de IA para generar el contenido y aclara que no planea traducir las guías.

System Design 101 frente a otras guías gratis

System Design Primer es el más completo y el único de los tres con CC BY 4.0, que sí permite traducir, adaptar y usar comercialmente citando al autor. karanpratapsingh/system-design es un curso lineal con la misma licencia restrictiva que System Design 101. Lo razonable es combinarlos: System Design 101 para la vista rápida, y los otros dos para profundizar.

Errores frecuentes

Las imágenes no cargan al leer el repo sin conexión. Los diagramas están en assets.bytebytego.com, no en el repositorio. Necesitas internet para verlos o leer las guías en la web.

Los enlaces del README no abren los archivos del repo. El índice apunta a bytebytego.com/guides/<nombre>. Para el Markdown local, abre data/guides/<nombre>.md: el nombre del archivo coincide con el final de la URL.

grep por categoría devuelve guías de más. Busca la clave exacta de data/categories (por ejemplo database-and-storage, no database), porque la palabra suelta también aparece en las etiquetas y en el texto.

GitHub dice «Other» en la licencia. No falta licencia: es una Creative Commons, que GitHub no clasifica como licencia de software. Léela en LICENSE.md.

Preguntas frecuentes

¿System Design 101 es gratis? Sí. Las 400 guías se leen gratis en GitHub y en la web de ByteByteGo. ByteByteGo vende aparte cursos y libros más extensos.

¿Es open source? El repositorio es público, pero la licencia CC BY-NC-ND 4.0 no es open source según la definición de la OSI: prohíbe el uso comercial y las obras derivadas.

¿Está en español? No. Todo está en inglés y CONTRIBUTING.md dice que no planean traducciones. Tampoco puedes publicar tu propia traducción sin permiso.

¿Basta para aprobar una entrevista de system design? Sirve como mapa y repaso, pero las guías son cortas. Combínalo con un material más profundo, como System Design Primer, y practica diseñando sistemas completos en voz alta.

¿Puedo usar sus diagramas en mi blog o en mis clases? Solo sin cambios, citando la fuente y sin fines comerciales. Si tu blog tiene anuncios o tus clases son de pago, necesitas permiso de ByteByteGo o hacer tus propios diagramas.

¿Sigue actualizándose? El último commit es del 4 de abril de 2025. El contenido sigue siendo válido porque son conceptos de fondo, pero no esperes guías nuevas en el repositorio.

Conclusión

System Design 101 es la forma más rápida de tener un mapa completo del diseño de sistemas: 400 temas, un diagrama por tema y nada de relleno. Úsalo para repasar y para saber qué te falta, y profundiza con otros materiales. Antes de reutilizar nada, recuerda que su licencia CC BY-NC-ND solo permite leerlo y compartirlo tal cual. Si quieres ver más proyectos gratuitos que sustituyen herramientas de pago, mira nuestra guía de Open Code Review para revisar código con IA.