Ir al contenido
Pieza

Framework modular, abierto y gratis

Arma tu app por módulos, como un rompecabezas.

Cada pieza es un módulo probado: tu propia IA, idiomas, actualizaciones seguras, un catálogo de la comunidad… Eliges los módulos, tu IA los enchufa y tu app queda armada. Cada app que se hace deja módulos para la siguiente.

Empezar Ver el código
—apps hechas con Pieza
—piezas en el catálogo
—listas para usar

En construcción: recién estamos sacando las piezas de las apps de la familia. Súmate a extraer las que faltan

Cómo funciona

Cuatro pasos. Tú hablas; tu IA y las piezas hacen el resto.

  1. 1

    Cuéntale tu idea a tu IA.

    Con tus palabras, como se la contarías a alguien. Por ejemplo: «una app para ordenar mis recetas».

  2. 2

    Mira la ficha antes de crear nada.

    Ves qué pantallas tendrá, qué permisos pide y si sale a internet. Si algo no te gusta, lo cambias.

  3. 3

    Las piezas se enchufan solas.

    Idiomas, tu IA, actualizaciones… ya probadas en otras apps. Nada se escribe de cero.

  4. 4

    Se mantienen al día solas.

    Cuando una pieza mejora, tu app recibe el arreglo sin perder lo que tú cambiaste.

Por dentro, para quien programa
Cuentas tu idea
Una sola ronda de preguntas. Tu IA te recomienda las piezas que calzan, y las que toda app necesita van solas.
Revisas la ficha
Antes de crear nada ves todo: pantallas, configuración, permisos por plataforma, a qué sale a internet y lo que solo puedes hacer tú.
Enchufas y creces
Las piezas se copian a tu app y son tuyas. Cuando una mejora, la recibes sin perder tus cambios; cuando tú la mejoras, vuelve a todas.

Empezar

¿Qué IA usas?

  1. Claude Code: Copia y pega esto en tu terminal

    claude plugin marketplace add pieza-app/pieza && claude plugin install pieza@pieza
    Ver detalles

    Instala el plugin: trae el flujo para crear apps y el de revisar aportes.

    Si ya estás dentro de Claude Code, escribe estos dos comandos:

    /plugin marketplace add pieza-app/pieza
/plugin install pieza@pieza

    Gemini CLI: Copia y pega esto en tu terminal

    gemini extensions install https://github.com/pieza-app/pieza --auto-update
    Ver detalles

    Instala la extensión: las mismas skills y los comandos /pieza:crear y /pieza:revisar.

    Codex: Copia y pega esto en tu terminal

    git clone https://github.com/pieza-app/pieza && python3 pieza/herramientas/pieza.py skills instalar codex
    Ver detalles

    Instala las skills en ~/.agents/skills (las pone al día sin borrar tu configuración local).

    claude.ai: Descarga y súbelas a tu cuenta

    Crear apps (.zip)Revisar aportes (.zip)

    Ver detalles

    Descarga las skills y súbelas en las capacidades de tu cuenta.

    lanzar-proyecto-open-source.zip · revisar-aportes-open-source.zip

    Otra IA: Clona y pídele que siga AGENTS.md

    git clone https://github.com/pieza-app/pieza
    Ver detalles

    ¿Otra IA? Clona el repo y pídele que siga AGENTS.md. Equivalencias entre herramientas: docs/otras-ias.md

  2. Pídele: «creemos una app para…»

    Creemos una app para ordenar mis recetas.

  3. Mira la ficha y di que sí

    Pantallas: 4 Permisos: ninguno Internet: solo actualizaciones Sí, créala

Hechas con Pieza

Repos públicos con el topic «hecho-con-pieza» en GitHub. Sin telemetría: solo aparecen los que eligen aparecer. Las de la familia son de donde salieron las piezas y van pasando a usarlas una por una.

    ¿Hiciste una app con Pieza?

    Ponle el topic hecho-con-pieza a su repo y aparece aquí. Cómo se hace

    Si quieres, suma el sello a tu README o tu página:

    Hecho con Pieza

    [![Hecho con Pieza](https://pieza-app.github.io/pieza/sello.svg)](https://pieza-app.github.io/pieza/)

    Construimos en abierto. Compartimos lo que funciona. Nadie es dueño de tu computador más que tú.

    Pieza nació de una idea simple: si alguien ya resolvió algo bien, nadie más debería tener que resolverlo de nuevo. Cada app de esta familia dejó piezas para la siguiente. Ahora esas piezas son de todos.

    Lo que creemos

    1. Tu computador es tuyo. Las apps viven ahí, con tus datos ahí. Nada de servidores que te miran, ni cuentas que te amarran, ni telemetría.
    2. Tu IA es tuya. Usamos la que ya tienes, con tu cuenta. Nunca la nuestra. Nunca entre tú y tus datos.
    3. El código se comparte. Todo es abierto: las piezas son MPL-2.0 (si mejoras una pieza, tu mejora es de todos; tu app elige su licencia) y las herramientas y las apps de la familia, AGPL-3.0. Puedes leerlo, cambiarlo y usarlo.
    4. Sin fines de lucro. Sin publicidad, sin planes pagados, sin «versión pro». Esto existe porque es útil, no para venderte algo.
    5. Aprender de quien lo hace mejor. Cada aporte se revisa buscando qué hizo mejor la otra persona. Lo que se aprende se anota y llega a todas las apps.
    6. Crédito siempre. Quien aporta aparece con su nombre en lo que hizo.
    7. Seguro antes que rápido. Lo que viene de afuera se valida. Lo que se instala como seguro, alguien lo leyó entero.
    8. Para cualquier persona. Si no se entiende sin manual, está mal hecho. El idioma se pregunta primero.

    Súmate

    No necesitas permiso para empezar. Una pieza tuya puede ahorrarle semanas a alguien al otro lado del mundo.

    Leer el manifiesto completo Hecho en Chile, para cualquier lugar. Por gente que comparte lo que sabe.

    Preguntas frecuentes

    ¿Pieza es un framework?

    Sí, con una diferencia: las piezas se copian dentro de tu app y son tuyas. No dependes de un paquete que pueda romperse desde afuera, y cuando una pieza mejora la recibes sin perder tus cambios.

    ¿Necesito Claude Code?

    No. Los flujos funcionan igual en Claude Code, Gemini CLI y Codex, y con cualquier otra IA siguiendo AGENTS.md. La herramienta pieza.py funciona sola, con Python.

    ¿Pieza manda datos a algún servidor?

    No. No hay servidores ni telemetría. El contador de apps solo cuenta repos públicos que se pusieron el topic hecho-con-pieza en GitHub.

    ¿Cómo me entero de las versiones nuevas de una pieza?

    Cada app hecha con Pieza trae el workflow «Pieza al día»: una vez por semana abre un PR con los arreglos y mejoras que se pueden aplicar solos, y un issue con los pasos para lo que hay que hacer a mano.

    ¿Qué licencia tiene?

    Las piezas, MPL-2.0: si cambias un archivo de una pieza, compartes ese cambio, pero tu app puede tener la licencia que quieras (incluso cerrada). Las herramientas de Pieza y las apps de la familia, AGPL-3.0. Todo gratis y abierto.

    Lo que no se negocia

    • Los datos son de la persona: en su computador o en su git.
    • La IA es la de la persona, con su cuenta, y sin poder tocar nada que no le mandemos.
    • Lo que escribe la persona nunca va como argumento de un proceso.
    • Sin dependencias: Python con su biblioteca estándar, web sin CDN.
    • El idioma se pregunta primero.
    • Abierto y gratis, sin cuentas ni seguimiento.