Primeros pasos

Instalado con un comando

Un solo comando instala molto y pickup como binarios estáticos, verificados por checksum y sin root. De cero a un programa funcionando en cosa de un minuto.

$ curl -fsSL https://moltobuild.dev/install.sh | sh

Las releases publican binarios sólo para x86-64 Linux. Windows y macOS están aparcados a propósito hasta que el ecosistema tenga profundidad en una sola plataforma; en otra arquitectura, compila desde el código fuente.

Lo que necesita la máquina

Tres cosas, y la tercera es opcional porque pickup puede traértela.

x86-64 Linux
Los binarios son estáticos: no requieren glibc ni hay nada que descomprimir.
curl
Para descargar los binarios. El instalador no necesita nada más.
Un compilador de C o C++, más adelante
Para construir tus propios proyectos, no para instalar Molto. pickup install clang trae uno si la máquina no tiene ninguno.

Paso 1: Instala molto y pickup

Un solo comando descarga ambos binarios, los verifica contra el SHA256SUMS publicado junto a la release y los deja en ~/.local/bin. Sin root y sin nada que descomprimir.


    
                $
                curl -fsSL https://moltobuild.dev/install.sh | sh
            
                
                  ==> pickup 0.3.3
            
                
                      checksum verified
            
                
                  ==> molto 0.16.0
            
                
                      checksum verified

Lee el script antes de pasarlo por un shell: se sirve desde este mismo sitio y son 200 líneas. Las opciones van después de --, por ejemplo | sh -s -- --dir /usr/local/bin, o --no-pickup para instalar sólo molto.

Paso 2: Comprueba con qué puede construir la máquina

Molto nunca elige compilador por su cuenta: se lo pregunta a pickup, y pickup demuestra cada capacidad compilando un programa que la usa. doctor dice qué falta y cómo arreglarlo.


    
                $
                molto --version
            
                
                molto 0.16.0
            
                $
                pickup doctor
            
                
                  ✓ gcc@12.3.0    c17, c++17

Si esta máquina no tiene ningún compilador lo bastante reciente, pickup install clang descarga uno en ~/.pickup. Necesita curl, tar y zstd en el PATH.

Paso 3: Crea tu primer proyecto

molto new escribe Project.toml, src/main.c, include/, tests/ y un .gitignore. Nunca sobrescribe un archivo que ya exista.


    
                $
                molto new my_app
            
                $
                cd my_app
            
                $
                molto run
            
                
                Hello, world!

molto run construye primero y luego propaga el código de salida del programa. molto test construye un ejecutable por archivo de tests/.

Otras formas de instalar

El instalador es una comodidad, no un requisito.

A mano, desde la release

Exactamente lo que hace el script, paso a paso: descargar el binario, verificarlo contra los checksums y ponerlo en tu PATH.


    
                $
                base=https://github.com/moltobuild/molto/releases/download/v0.16.0
            
                $
                curl -fsSLO $base/molto-0.16.0-x86_64-linux
            
                $
                curl -fsSLO $base/SHA256SUMS
            
                $
                sha256sum --check --ignore-missing SHA256SUMS
            
                $
                install -Dm755 molto-0.16.0-x86_64-linux ~/.local/bin/molto

Desde el código fuente

El Makefile es el bootstrap: existe para el caso en que todavía no hay ningún molto. Necesita gcc 12 o superior y GNU Make. Una vez lo tienes, molto también se construye a sí mismo.


    
                $
                git clone https://github.com/moltobuild/molto
            
                $
                cd molto && make build
            
                $
                install -Dm755 build/molto ~/.local/bin/molto

Cuando no funciona

Las cuatro cosas que de verdad fallan en una primera instalación.

command not found: molto
El binario quedó en ~/.local/bin y tu shell no lo busca ahí. Añádelo al PATH en el perfil de tu shell.
export PATH="$HOME/.local/bin:$PATH"
Molto dice que ninguna toolchain cumple lo que pide el proyecto
Pregúntale a pickup qué encontró. Si la máquina de verdad no tiene nada suficientemente reciente, deja que pickup traiga uno a ~/.pickup.
pickup doctor && pickup install clang
Molto no encuentra pickup
Molto busca pickup en el PATH. Apúntalo a otro sitio con MOLTO_PICKUP.
export MOLTO_PICKUP="$HOME/.local/bin/pickup"
Compila con make, pero bajo Molto falla cada #include
Molto descubre tus fuentes, nunca tus ajustes de build. Un manifiesto sin include compila sin ningún -I.
include = ["include"]

Por dónde seguir

Project.toml tiene una clave para todo lo que el build necesita: perfiles, defines, librerías, disposición de los tests y dependencias. La referencia vive en el repositorio mientras estas páginas se escriben.

Leer docs/Project.md